graph

Render the spec to target to file dependency graph for the current project.

graph walks the loaded spec bundle, asks every configured target adapter which files each spec produces, and prints the result. Read-only: it never invokes Emit on disk. Output is deterministic, sorted by spec name then target.

Synopsis

agnostic-ai graph [flags]

Flags

Flag	Description
`--format <text\|mermaid\|dot\|json>`	Output format. Default `text`.
`--target <name>`	Restrict to one target.
`--spec <name>`	Restrict to one spec name.
`--kind <kind>`	Restrict to one kind (`agent`, `skill`, `rule`, `hook`, `mcp`, `command`).

Formats

text (default)

Aligned matrix. Rows are specs, columns are targets. Each cell is the kind that target emits, or - when nothing was produced.

spec           | claude cursor codex
code-reviewer  | agent  agent  agent
no-console-log | rule   rule   rule
other          | rule   rule   rule

mermaid

graph LR for embedding in markdown docs.

graph LR
  S_no_console_log["no-console-log"] --> T_claude["claude"] --> F_0[".claude/rules/no-console-log.md"]
  S_no_console_log["no-console-log"] --> T_cursor["cursor"] --> F_1[".cursor/rules/no-console-log.mdc"]

dot

Graphviz directed graph. Pipe to dot(1) for SVG/PNG.

agnostic-ai graph --format dot | dot -Tsvg > graph.svg

digraph agnostic_ai {
  rankdir=LR;
  "no-console-log" -> "claude" -> ".claude/rules/no-console-log.md";
  "no-console-log" -> "cursor" -> ".cursor/rules/no-console-log.mdc";
}

json

One record per edge, for editor extensions and scripts.

[
  {
    "spec": "no-console-log",
    "kind": "rule",
    "target": "claude",
    "path": ".claude/rules/no-console-log.md"
  }
]

Examples

# Default matrix view
agnostic-ai graph

# Only the claude column
agnostic-ai graph --target claude

# One spec across every target
agnostic-ai graph --spec no-console-log

# Only rule-kind edges, as JSON
agnostic-ai graph --kind rule --format json

# Render an SVG of the whole graph
agnostic-ai graph --format dot | dot -Tsvg > graph.svg