agentgraph list gives you a table of every run in your runs directory, with status, DAG name, start time, and a node count breakdown. agentgraph resume is a shorthand that continues a run from where it left off — useful after an approval gate is cleared or after a crash.
- list
- resume
agentgraph list
List all runs in the runs directory, ordered by most recent first.Flags
Directory containing run subdirectories to scan.
Filter results to runs matching a derived status. Options:
completed, paused, partial, failed.Maximum number of rows to display.
Examples
Output table
list prints a table with one row per run:| Column | Contents |
|---|---|
| run_id | 12-character hex run identifier |
| dag | DAG name as declared in the YAML name: field |
| started | ISO 8601 timestamp when the run began |
| status | Derived status (see below) |
| nodes | Node status counts, e.g. completed=3, failed=1 |
Status derivation
agentgraph derives run status from the node table at list time — there is no separate run-level status field:| Derived status | Condition |
|---|---|
paused | At least one node is awaiting_approval |
failed | At least one node is failed (and none are awaiting approval) |
completed | Run has a finished_at timestamp set |
partial | None of the above — run stopped mid-way without a clean finish |