Runbooks

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 durable repo runtime

Approvals + handoffs

Day-to-day plan operation

Troubleshooting

Something broke

Platform notes

Platform-specific quirks (launchd, systemd-user, SCM, WSL)

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.”