Task
agh task
Manage tasks and task runs
- Audience
- Operators running durable agent work
- Focus
- Task guidance shaped for scanability, day-two clarity, and operator context.
agh task
Manage tasks and task runs
agh task [flags]Examples
# Create durable task intent without starting execution
agh task create --scope workspace --workspace checkout-api --title "Audit auth flow"
# Explicitly enqueue execution for an existing task
agh task start task-123 --channel coord-run-123
# Let the current agent session claim work
agh task next --waitOptions
-h, --help help for taskOptions inherited from parent commands
--json Emit JSON output
-o, --output string Output format: human, json, jsonl, or toon (default "human")Output Formats
Every AGH command supports -o, --output:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Example:
agh task -o jsonSubcommands
| Command | Description |
|---|---|
| agh task approve | Approve a task and enqueue its first run |
| agh task cancel | Cancel a task tree |
| agh task child | Manage child tasks |
| agh task complete | Complete a claimed task run for the current agent session |
| agh task create | Create a task |
| agh task delete | Delete a task |
| agh task dependency | Manage task dependencies |
| agh task fail | Fail task runs through a session-bound lease or operator override |
| agh task get | Show one task with related detail |
| agh task heartbeat | Extend a claimed task run lease for the current agent session |
| agh task inspect | Inspect a task or run with diagnostics |
| agh task list | List tasks |
| agh task next | Claim the next task run for the current agent session |
| agh task notification | Manage task terminal notifications |
| agh task pause | Pause new runs for one task |
| agh task profile | Manage task execution profiles |
| agh task publish | Publish a draft task and enqueue its first run |
| agh task recover | Recover one needs_attention task run |
| agh task reject | Reject a pending approval task |
| agh task release | Force release claimed task runs back to the queue |
| agh task resume | Resume new runs for one paused task |
| agh task retry | Retry one failed task run |
| agh task review | Manage task-run reviews |
| agh task run | Manage task runs |
| agh task start | Enqueue a run for an executable task |
| agh task update | Update mutable task fields |