Runbooks
Runbooks
Operator-facing runbooks for install, auth, service, troubleshooting.
Task-oriented operator documentation. If you're not sure where to start, go to install-first-run.
Live runbooks
| Page | Use when |
|---|---|
| Install + first run | Fresh install on a new machine |
| Provider auth | doctor reports a provider check fails, or you're switching providers |
| Service install/start/stop/recover | Managing the macOS/Linux service; native Windows limited control plane/remediation |
| Troubleshooting | Something broke |
| Platform notes | Platform quirks (launchd, systemd-user, native Windows limitations, functional WSL2) |
Runbooks are kept separate from the guides (docs/guides/) because
they answer "how do I do X" — guides answer "why does X work this
way."
