ReleaseLatest release v0.10.2 · 24 paź 2026These pages describe v0.10.2, the published release.Changelog →

Built-in tools

In the published release, every session starts with thirteen native tools for reading, editing, running commands, and delegating, plus tool_search. Codewhale loads specialized tools only when a task needs them, and your mode and approval setting still apply to all of them.

Tool contract and design rationale
read
path · offset? · limit?
write
path · content
edit
path · edits
file_search
Find workspace files by name, path, or glob pattern.
bash
command · timeout?
agent
Delegate work to child agents.
todo_write
Replace the task list with content and status entries.
create_goal · get_goal · update_goal
Create, inspect and update the active goal.
task_shell_wait
Poll or stop a background shell task by task_id.
load_skill
Load a skill by exact name, or pass query to search the catalogue.
tool_search
Discover policy-allowed tools. Each child has its own search and activation cache.
workflow
Plan, run and inspect multi-agent phases with dependencies and completion checks.
Git · Run · tasks · remember · Web · MCP · plugins
Deferred: loaded by tool_search only when policy permits.
8 names / 16 KiB
Conversation toolbox cache; independent per child and revalidated every turn.
Web search/fetch
Scout and Reviewer children can discover these without gaining mutation or arbitrary network authority.
MCP
mcp_<server>_<tool> — registered from ~/.codewhale/mcp.json.

W kodzie źródłowym, jeszcze niewydane

This section describes behavior that exists in the project's source and is not in the published release. Check which version you have with codewhale --version.

Every session starts with fourteen native tools for reading, editing, running commands, and delegating, plus tool_search.

grep_files
Find matching content in workspace files.
present
Hand off 1–32 existing files with SHA-256 receipts; read-only.
workflow · context_archive_search · context_archive_get · Git · Run · tasks · remember · Web · MCP · plugins
Deferred: loaded by tool_search only when policy permits. context_archive_search and context_archive_get search and read compacted history, with credentials masked.

Read language-server diagnostics

After file edits, LSP diagnostics can report errors to the agent. Add a custom server by file extension under [lsp.custom]; install the server executable separately.

PHP and custom LSP server setup

Replay compatibility

Legacy names remain only for saved transcripts and protocol clients. Exact old calls retain their handlers but stay out of new catalogs and tool_search. Unknown names are never guessed or rewritten.

docs/RUNTIME_SIMPLIFICATION_DESIGN.md →