List dagraph runs and resume incomplete ones quickly

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.

agentgraph list [OPTIONS]

Flags

string

default:"runs"

Directory containing run subdirectories to scan.

string

Filter results to runs matching a derived status. Options: completed, paused, partial, failed.

number

default:"20"

Maximum number of rows to display.

Examples

agentgraph list

agentgraph list --status paused

agentgraph list --status failed --limit 50

agentgraph list --runs-dir /data/production-runs

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

agentgraph resume

Resume a paused or partial run. This is syntactic sugar for agentgraph run <dag_path> --run-id <run_id> — the scheduler skips all nodes that already have a completed status and re-runs only the pending, failed, or newly unblocked nodes.

agentgraph resume <dag_path> <run_id> [OPTIONS]

Arguments and flags

string

required

Path to the DAG YAML file that was originally executed.

string

required

Run ID of the run to resume.

string

Override or supplement template inputs. Original inputs are replayed from the checkpoint; use this flag only if you need to change a value.

string

default:"runs"

Runs directory.

string

default:"claude_code"

Executor backend. See agentgraph run for options.

string

Sandbox for exec nodes. Required if your DAG contains bash or python_exec nodes.

Examples

agentgraph resume examples/approval_flow.yaml a1b2c3d4e5f6

agentgraph resume examples/research.yaml a1b2c3d4e5f6 --backend api

agentgraph resume examples/research.yaml a1b2c3d4e5f6 \
  --input topic="updated topic"

Common resume workflow

Find a paused run

agentgraph list --status paused

Clear the gate

agentgraph approve <run_id> <node_id>

Resume execution

agentgraph resume examples/my_dag.yaml <run_id>

Only nodes that did not complete previously will execute.

resume and run --run-id are identical in behavior. Use resume when you want the intent to be explicit in scripts and shell history.

​agentgraph list

​Flags

​Examples

​Output table

​Status derivation

​agentgraph resume

​Arguments and flags

​Examples

​Common resume workflow

agentgraph list

Flags

Examples

Output table

Status derivation

agentgraph resume

Arguments and flags

Examples

Common resume workflow