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 supervisor as a per-user OS service
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.”