AIgency troubleshooting
Diagnose a stuck run by the specific status its task is in, rather than treating every stall the same way.
AgentDock Pro
This page covers AIgency, available only in AgentDock Pro.
AIgency's task statuses are specific on purpose (see Execution) — the fastest way to diagnose a stuck run is to check exactly which status a stalled task is in rather than assuming it's broken.
Diagnose by status
| Status | What it means | Where to look |
|---|---|---|
pending with unmet dependencies | Blocked on another task, not stuck | Workflow graph |
waiting_interaction | An agent raised a question or prompt needing your answer | Needs Attention |
waiting_capacity | Provider rate limit or quota | Capacity recovery |
waiting_workspace | Waiting for an isolated worktree slot to free up | Worktree problems |
failed | Retry and fallback budget exhausted | Retries, Run history |
| Flagged as a possible stall | Long mid-run silence, not yet failed | Stall detection |
| Run stuck after an app restart | Recovery is reconciling persisted state | Restart and crash recovery |
General approach
Switch to Technical View for the detail Simple View doesn't show, check the raw terminal drawer if an agent's own output would help, and remember that waiting_capacity and waiting_workspace are not failures — they resolve on their own and don't need manual intervention unless they persist far longer than expected.