Cli referenceScheduler
compozy scheduler
Inspect and control task scheduler dispatch
- Audience
- Operators running durable agent work
- Focus
- Scheduler guidance shaped for scanability, day-two clarity, and operator context.
compozy scheduler
Inspect and control task scheduler dispatch
compozy scheduler [flags]Examples
# Show scheduler pause and backlog pressure
compozy scheduler status
# Pause all new scheduler dispatch while active claims continue
compozy scheduler pause --reason "incident response"
# Pause and wait up to 30 seconds for active claims to finish
compozy scheduler drain --timeout 30sOptions
-h, --help help for schedulerOptions 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 scheduler -o jsonSubcommands
| Command | Description |
|---|---|
| compozy scheduler backlog | List queued runs visible to scheduler dispatch |
| compozy scheduler drain | Pause dispatch and wait for active task claims to finish |
| compozy scheduler pause | Pause new scheduler dispatch |
| compozy scheduler resume | Resume scheduler dispatch |
| compozy scheduler status | Show scheduler pause and queue pressure |