CLI
sazabi runs
Command reference for sazabi runs.
sazabi runs — Inspect deferred agent runs. Subcommands: list, get, cancel, stream.
sazabi runs
Inspect deferred agent runs
sazabi runs <subcommand>sazabi runs list # List recent runs for the active project
sazabi runs get <run-id> # Check current run status
sazabi runs get <run-id> --wait # Wait until the run is terminal
sazabi runs cancel <run-id> # Request cancellation of a run
sazabi runs stream <run-id> # Stream run events in real timesazabi runs list
List runs for the active project
sazabi runs list [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--limit | string | No | Maximum number of runs to return (1–100, default 50) |
--cursor | string | No | Cursor from a previous response to fetch the next page |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi runs list # List recent runs for the active project
sazabi runs list --limit 10 # List the 10 most recent runs
sazabi runs list --json # Output as JSONsazabi runs get
Get a deferred run by run ID
sazabi runs get <run-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--wait | boolean | No | Wait for terminal status and print the final result; exits 0 completed, 3 error, 4 aborted |
--timeout | string | No | Timeout in seconds to wait; on timeout prints the processing state and exits 124 (the run keeps going) |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi runs get <run-id> # Check current run status
sazabi runs get <run-id> --wait # Wait until the run is terminal
sazabi runs get <run-id> --wait --timeout 60 # Wait up to 60 seconds
sazabi runs get <run-id> --json # Output run state as JSON
sazabi runs stream <run-id>; sazabi runs get <run-id> --wait --json # Follow progress, then exit with the outcomesazabi runs cancel
Request cancellation of an in-flight run
sazabi runs cancel <run-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--json | boolean | No | Output as JSON |
--api-base-url | string | No | Override API base URL |
sazabi runs cancel <run-id> # Request cancellation of a run
sazabi runs cancel <run-id> --json # Output the result as JSONsazabi runs stream
Stream a run's agent events in real time
sazabi runs stream <run-id> [options]| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token |
--cursor | string | No | Resume from a prior stream cursor after a disconnect |
--json | boolean | No | Emit one NDJSON event per line (stdout carries events only) |
--api-base-url | string | No | Override API base URL |
sazabi runs stream <run-id> # Follow run events (human-readable)
sazabi runs stream <run-id> --json # Emit NDJSON events for tools
sazabi runs stream <run-id> --cursor seq:42 # Resume after a disconnect