Cli reference
agh doctor
Run runtime diagnostics
- Audience
- Operators running durable agent work
- Focus
- Doctor guidance shaped for scanability, day-two clarity, and operator context.
agh doctor
Run runtime diagnostics
agh doctor [flags]Examples
# Run diagnostics
agh doctor
# Return diagnostic items for agents
agh doctor -o json
# Run only provider and MCP diagnostics
agh doctor --only provider --only mcpOptions
--exclude strings Exclude the named probe ids or categories
-h, --help help for doctor
--only strings Run only the named probe ids or categories
--quiet Omit OK diagnosticsOptions 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 doctor -o json