human execution

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 <id>	Block until the execution completes (CI-friendly)
status <id>	Show execution details
pause <id>	Pause a queued or processing execution
resume <id>	Resume a paused execution
cancel <id>	Cancel a queued or paused execution

Common Flags

Flag	Description
--json	Output as JSON
--status <status>	Filter: queued, processing, paused, completed, failed, cancelled
--timeout <s>	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