Recover
Fix the failed stage, not the symptom.
RightSide returns structured failures so agents can make bounded repairs. Start with diagnostics, identify the stage, and use the suggested fix before reading more logs.
Start with doctor
rightside doctor --jsonFailure guide
| Area | Check |
|---|---|
| Installation | Confirm Node.js is at least 22.13 and ~/.local/bin is on PATH. |
| Authorization | Run rightside login --url https://api.rightside.host. Invite-only closed beta access must be allowlisted. |
| MCP registration | Run rightside install claude or rightside install codex, then rerun doctor. |
| Build | Read build logs. Fix the Dockerfile, dependency lock, ignored file set, or build command in source. |
| Health | Bind 0.0.0.0:$PORT and return success from the configured health path. |
| Runtime | Use rightside logs NAME --runtime. Do not paste sensitive output into chat. |
Retry discipline
- Record the structured error code and failed stage.
- Apply one source-level correction tied to that evidence.
- Run the smallest relevant local check.
- Deploy again.
- Escalate after repeated identical failures instead of looping blindly.