Task
compozy task next
Claim the next task run for the current agent session
- Audience
- Operators running durable agent work
- Focus
- Task guidance shaped for scanability, day-two clarity, and operator context.
compozy task next
Claim the next task run for the current agent session
compozy task next [flags]Examples
# Claim the next available run for this session
compozy task next
# Wait until matching work is claimable and request a five-minute lease
compozy task next --wait --lease-seconds 300 -o json
# Claim one exact queued run through the canonical lease path
compozy task next --run-id run-123 -o json
# Filter by required caller capability
compozy task next --capability go.test --priority-min 10Options
--capability stringArray Caller capability filter (repeatable)
-h, --help help for next
--idempotency-key string Optional idempotency key
--lease-seconds int Lease duration in seconds
--priority-min int Minimum task priority
--run-id string Claim exactly this queued run
--wait Wait until work is claimable
--workspace string Override workspace binding (ID, name, or path)Options 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 next -o json