Docs
Documentation.
Everything here is read from the repository at build time, so the site says what the code says.
Pages
The guide and the manual, each lifted straight from the repository.
- 01Getting startedSix steps from a fresh install to reviewing work Owl did while you were away.docs/guide/getting-started.md
- 02Working with JobsQueueing and ordering Jobs, following a Run, and deciding what to do with the work.docs/guide/jobs.md
- 03Projects and AccountsThe repositories Jobs are queued against, the subscriptions they run on, and the instructions every Run reads.docs/guide/projects-and-accounts.md
- 04Chat model providersWhere the desktop chat gets its model: Anthropic, OpenRouter, and how a key is configured.docs/guide/chat-providers.md
- 05GuideHow Owl works, installing it, a quick start, configuration and the command overview.README.md
- 06DecisionsAll 39 architecture decision records, one per decision, oldest first.docs/adr/
Recent decisions
The last five architecture decision records.
- 0039Each Account may have one Focus, a Project whose Jobs go first2026-09-19
- 0038A Shift lets Owl work on an Account while the machine is in use2026-09-19
- 0037An Account carries standing instructions, kept as the tool's own file2026-09-17
- 0036Every Run is bounded by a timeout and a stall limit2026-09-17
- 0035An unattended Agent is granted a default allowlist, once, per Account2026-09-14