Troubleshooting

Common AO problems and concrete fixes. Most start with `ao doctor`.

First step: `ao doctor`

ao doctor
ao doctor --fix           # auto-repair safe things
ao doctor --test-notify   # send a test through each notifier

Covers: install health, plugin resolution, notifier connectivity, stale temp files.

Check the FAQ.
Open an issue: ComposioHQ/agent-orchestrator. When opening an issue, include:
Output of ao --version
The contents of ~/.agent-orchestrator/{hash}-observability/processes/ (one JSON snapshot per process; each contains traces, health, and metrics)
Your agent-orchestrator.yaml (redact any secrets)