Cli referenceScheduler
agh 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.
agh scheduler
Inspect and control task scheduler dispatch
agh scheduler [flags]Examples
# Show scheduler pause and backlog pressure
agh scheduler status
# Pause all new scheduler dispatch while active claims continue
agh scheduler pause --reason "incident response"
# Pause and wait up to 30 seconds for active claims to finish
agh 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 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 scheduler -o jsonSubcommands
| Command | Description |
|---|---|
| agh scheduler backlog | List queued runs visible to scheduler dispatch |
| agh scheduler drain | Pause dispatch and wait for active task claims to finish |
| agh scheduler pause | Pause new scheduler dispatch |
| agh scheduler resume | Resume scheduler dispatch |
| agh scheduler status | Show scheduler pause and queue pressure |