Task
AGH RuntimeTask
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 dependency | Manage task dependencies |
| agh task fail | Fail a claimed task run for the current agent session |
| 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 list | List tasks |
| agh task next | Claim the next task run for the current agent session |
| agh task publish | Publish a draft task and enqueue its first run |
| agh task release | Release a claimed task run for the current agent session |
| agh task run | Manage task runs |
| agh task start | Enqueue a run for an executable task |
| agh task update | Update mutable task fields |