agentgraph inspect opens a run’s SQLite checkpoint and artifact store and prints the status of every node alongside a preview of its output. Use it to verify what each node produced, debug a failed run, or read the full artifact from a specific node.
Arguments and flags
string
required
The run ID to inspect. Run IDs are printed at the start of every
agentgraph run invocation and listed by agentgraph list.string
default:"runs"
Directory containing run subdirectories. Override if you used a custom
--runs-dir when running the DAG.string
Show the artifact for a single node instead of all nodes. Combine with
--full to print the complete output.boolean
Print the complete artifact content without truncation. By default, long artifacts are truncated at
--truncate characters.number
default:"2000"
Character limit for artifact previews when
--full is not set. Truncated content shows a count of remaining characters and a reminder to use --full.Examples
Output format
inspect prints two sections: a run info panel followed by a nodes table.
Run info panel — shows run ID, DAG name, start time, finish time (or a note if the run is still in progress), and the input values used.
Nodes table — one row per node, with four columns:
After the table,
inspect prints an artifact preview panel for each completed or skipped node. For failed nodes, the error message appears in the table row.
Node status values
If
finished shows — (running or interrupted), the run did not complete cleanly. Use agentgraph resume or re-run with --run-id to continue from where it stopped.