Guides
Task-shaped walkthroughs: configuring agents, writing settings.kdl, theming the dashboard.
Guides take a single task and walk you through it end-to-end — what to write, where to write it, and what happens when you do. They sit between the concepts (the “why”) and the reference docs (the “what flag does what”).
- Configuring the Claude agent — every config key the Claude agent accepts, with CLI and
settings.kdlforms. - Configuring the Codex agent — the same, for Codex, plus notes on the current orchestrator-compatibility limitation.
- The settings.kdl tour — a top-to-bottom walkthrough of the user / project config file: roles, per-agent defaults, hooks, ask blocks.
- Theming the watch dashboard — built-in themes and the omarchy desktop integration with live reload.
If you’re looking for a quick lookup rather than a walkthrough, jump to the Reference section.
- Configuring the Claude Agent Every config key the Claude agent accepts, with CLI and settings.kdl examples.
- Configuring the Codex Agent Every config key the Codex agent accepts, with CLI and settings.kdl examples.
- settings.kdl Tour Roles, per-agent defaults, hooks, and ask blocks — every top-level node explained.
- Theming the Watch Dashboard Built-in claude-dark / claude-light themes plus omarchy desktop integration.