human execution
Monitor and control async agent executions
Monitor and control async agent executions — the most common CI use case is execution follow which blocks until the execution reaches a terminal state.
Subcommands
| Subcommand | Description |
|---|---|
list | List executions with optional status filter |
follow | Block until the execution completes (CI-friendly) |
status | Show execution details |
pause | Pause a queued or processing execution |
resume | Resume a paused execution |
cancel | Cancel a queued or paused execution |
Common Flags
| Flag | Description |
|---|---|
--json | Output as JSON |
--status | Filter: queued, processing, paused, completed, failed, cancelled |
--timeout | Follow timeout in seconds (default 300) |
Examples
# Wait for an execution in CI
human execution follow exec_abc123 --timeout 120
# List running executions
human execution list --status processing
# JSON output for scripting
human execution status exec_abc123 --json | jq .status