CLI
circuit checkpoints
List runs parked at a checkpoint, waiting on a decision.
CLI only.
circuit checkpoints [--project-root <path>] [--runs-base <path>] [--json]List every run that paused at an operator checkpoint
and is waiting on a decision. For each waiting run, checkpoints shows the fork it
stopped on (what it asks and the choices it offers), a best-effort note on whether
the run has gone stale, and the circuit resume command that
answers it.
circuit checkpoints is read-only. It never resumes a run: it is a read model over
your saved run folders and a front door to circuit resume. You still answer one
run at a time.
Flags
| Flag | Description | Default |
|---|---|---|
--project-root <path> | Project whose runs to read. | current directory |
--runs-base <path> | Runs root, when runs live outside the project. | project control plane |
--json | Print a machine-readable result. |
Examples
See what is waiting on you:
circuit checkpointsThen answer one with the resume command it prints for it:
circuit resume --run-folder .circuit/runs/<run-id> --checkpoint-choice <choice>