Getting started
3npm, Cargo, Homebrew, Docker, Nix, Scoop, CNB mirror, and platform-specific notes.
First run, sessions, commands, keyboard shortcuts, and everyday workflows.
config.toml reference, environment variables, project overrides, and legacy paths.
Reference
1Core concepts
6Agent identity, authority hierarchy, evidence rules, and the nested law system.
Plan, Act, Operate modes and orthogonal permission posture.
Canonical action tools, deferred discovery, and replay compatibility.
The counted To-do ledger, update_plan strategy context, and how work state flows to the sidebar, relay, and sub-agents.
Parallel execution, role types, transcript handles, and nesting.
Available Seatbelt (macOS), opt-in bubblewrap (Linux), platform gaps, and approval policies.
Extending
4Model Context Protocol — consuming and exposing tools via stdio and HTTP/SSE.
Lifecycle hooks for pre/post tool execution, mode changes, and session events.
Public HTTP API for integrations, bridges, and automation.
Run the embedded browser client on loopback, with its one-time bootstrap and session boundaries.
Operations & community
3Durable task execution, fleet management, and Workflow authoring.
Common issues, diagnostics, operations runbook, and Docker notes.
Contributing guide, agent ethos, contributor credits, and release process.
Web guides stay on codewhale.net. Source docs open the complete reference in the GitHub repository. The index is maintained from the docs-map.ts registry in the repository.