Troubleshooting
Start read-only, then gated mutate. Prefer CLI verbs that emit machine-readable reasons.
In this section
| Page | Topic |
|---|---|
| Common failures | doctor, can-deploy, STALE_FENCE, schema, Station, OPFS |
| Local debugging | hobo dev, local Camp, dual fixtures |
| Remote development | Bridge modes: live / mock / bridge / replay / shadow / fault |
| Remote debugging | inspect, logs, incidents against real camps |
| Agent audit & replay | What the agent did — in the event log |
| Errors & codes | Stable machine codes (reference) |
Quick map
| Symptom | First command |
|---|---|
| Local env weird | hobo doctor |
| Deploy blocked | hobo verify / hobo can-deploy |
| Policy deny | inspect policy.Decided — do not retry |
| Append OCC | reload & retry |
STALE_FENCE | re-acquire lease |
| Control plane refuses | hobo station status |
| Agent can’t tool | scopes + MCP auth |