Issue 2026-07-11
v0.8.67
CodeWhale
any model, open models first
Section 02 · Docs

Documentation 文档

How CodeWhale works: ego, conflict law, evidence, modes, tools, sandbox, MCP, config, hooks. The full architecture walkthrough is in docs/ARCHITECTURE.md

Tools 工具

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

File ops
read_file · list_dir · write_file · edit_file · apply_patch
Search
grep_files · file_search · web_search · fetch_url
Shell
exec_shell · exec_shell_wait · exec_shell_interact
Git / diag / test
git_status · git_diff · diagnostics · run_tests
Sub-agents
agent — persistent sessions, parallel execution; see docs/SUBAGENTS.md
Recursive LM (RLM)
rlm_open · rlm_eval · rlm_configure · rlm_close — sandboxed Python REPL with peek/search/chunk/sub_query_batch helpers
MCP
mcp_<server>_<tool> — auto-registered from ~/.codewhale/mcp.json

Tool Lifecycle

Full lifecycle for tool registration, discovery, deprecation, and stabilization is documented in the repo.

docs/TOOL_LIFECYCLE.md →

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