Codewhale
GitHub
Codewhale documentation

Find the guidance you need.

Start with installation and first run, or go straight to modes, permissions, tools, providers, Fleet, MCP, and the Runtime API. These pages are the product documentation; each one cites the source documents in the repository for full detail.

Install CodewhaleBrowse source docs ↗

Tools 工具

Curated surface — see docs/TOOL_SURFACE.md for design rationale.

Bash
run · wait · interact · cancel
File
read · list · search_name · search_content · write · edit · patch
Git
status · diff · log · show · blame
Run
tests · verifiers
Coordination
agent · remember (when built-in memory is enabled) · tasks · update_plan · work_update · tool_search (synthetic and always active)
Deferred
Web (search · fetch · wait) loads through tool_search only when network policy permits; github, automation, and rlm are deferred by default
MCP
mcp_<server>_<tool> — auto-registered from ~/.codewhale/mcp.json

Replay compatibility

Legacy single-purpose names remain callable only so saved transcripts and automation can replay. They stay out of the model catalog and tool_search; new work uses the canonical action tools above.

docs/RUNTIME_SIMPLIFICATION_DESIGN.md →

Source documents: docs/TOOL_SURFACE.md, docs/RUNTIME_SIMPLIFICATION_DESIGN.md · Update docs-map.ts when changing.