docs

Codewhale documentation

Start with the user guide. The website renders a subset of these pages at codewhale.net/docs; the Markdown here is the source. Translations live beside their English page (*.id.md) or in id/ and zh_hans/.

Get started

• Installing Codewhale, including PATH help and shell completions
• User guide: first run, sessions, commands, everyday workflows
• Keybindings
• Pet mode: a glanceable whale view per terminal, with replies and agents on demand
• Modes and permission postures
• Configuration
• Providers and local models and the Model Lab roadmap
• Platform notes: Docker, Termux / Android, HarmonyOS, environment caveats, classroom and lab installs

Using Codewhale

• Local browser client (codewhale web)
• Agent fleet, sub-agents, and the fleet and workflow tutorial
• Workflow authoring, automatic workflows, and experimental workflow search
• Skills and evaluating skill changes
• User memory
• read_media and /preview-request

Extending Codewhale

• MCP servers
• Hooks
• Installing plugins, writing a plugin, plugin bundles, the first-party marketplace, and Claude plugin compatibility
• Writing an extension tool (experimental extension_host)
• LSP: PHP and custom language servers
• Runtime API and integration contract
• GitHub App setup
• DeepSeek Harness integration and DSH plugin compatibility

Safety and trust

• Authorization order
• Sandbox threat model
• Workroom security model
• Runtime receipts
• Signed cloud facts
• Telemetry
• Accessibility
• Security reports: see .github/SECURITY.md

Architecture

• Product and architecture overview
• Agent runtime and Codewhale Agent
• Command and control-plane contract
• Tool surface
• Prompt-cache stability
• Workroom architecture
• Design notes: architecture/, design/, decisions/, and rfcs/

Contributing and operating

• Contribution guide and agent ethos
• Voice and terminal charter, motion contract, and settings picker framework
• Issue triage
• Build and test performance
• Live smoke runs
• Localization matrix
• Dependency maintenance
• Release checklist and release runbook
• Operations runbook
• Catalog refresh and CNB mirror
• Agent skills for contributors: skills/

History and reference

• Feature registry: every user feature with its status, first release, docs page and owning code, checked against the code by a test
• Contributors
• Changelog archive and the lifecycle outbox changelog
• Rebrand: DeepSeek TUI to Codewhale and legacy .deepseek/ paths
• Third-party notices
• Historical plans: TUI modularization, post-0.9.1 seams, runtime simplification, tool lifecycle (v0.8.53)