Task
compozy task
Manage tasks and task runs
- Audience
- Operators running durable agent work
- Focus
- Task guidance shaped for scanability, day-two clarity, and operator context.
compozy task
Manage tasks and task runs
compozy task [flags]Examples
# Create durable task intent without starting execution
compozy task create --scope workspace --workspace checkout-api --title "Audit auth flow"
# Explicitly enqueue execution for an existing task
compozy task start task-123 --network live \
--network-channel-strategy named --network-channel coord-run-123
# Let the current agent session claim work
compozy 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 Compozy 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:
compozy task -o jsonSubcommands
| Command | Description |
|---|---|
| compozy task approve | Approve a task and enqueue its first run |
| compozy task block | Block a task with a typed reason |
| compozy task blocks | List task blocks |
| compozy task cancel | Cancel a task tree |
| compozy task child | Manage child tasks |
| compozy task complete | Complete a claimed task run for the current agent session |
| compozy task create | Create a task |
| compozy task delete | Delete a task |
| compozy task dependency | Manage task dependencies |
| compozy task fail | Fail task runs through a session-bound lease or operator override |
| compozy task fan-out | Enqueue designated sibling runs for one task |
| compozy task get | Show one task with related detail |
| compozy task heartbeat | Extend a claimed task run lease for the current agent session |
| compozy task inspect | Inspect a task or run with diagnostics |
| compozy task list | List tasks |
| compozy task next | Claim the next task run for the current agent session |
| compozy task notification | Manage task terminal notifications |
| compozy task pause | Pause new runs for one task |
| compozy task profile | Manage task execution profiles |
| compozy task promote | Promote one network thread message into a task |
| compozy task publish | Publish a draft task and enqueue its first run |
| compozy task recover | Recover a task from needs_attention |
| compozy task reject | Reject a pending approval task |
| compozy task release | Force release claimed task runs back to the queue |
| compozy task resume | Resume new runs for one paused task |
| compozy task retry | Retry one failed task run |
| compozy task review | Manage task-run reviews |
| compozy task run | Manage task runs |
| compozy task start | Enqueue a run for an executable task |
| compozy task unblock | Clear one task block |
| compozy task update | Update mutable task fields |