codewhale-hq /Codewhale
An open-source coding agent for your terminal, written in Rust. It works with any model, can split one task across several agents, and every line of it is yours to read.
★ 41,176⑂ 3,572👁 156⑃ 3,880● 3,233▤ 140
+3
Daily
+16
Weekly
41,176
stars
3,572
forks
156
watchers
3,880
prs
3,233
issues
140
releases
README
The model can be anyone's. The agent should be yours. Codewhale is an open-source coding agent for your terminal, written in Rust. It works with any model, can split one task across several agents, and every line of it is yours to read. bash curl -fsSL https://codewhale.net/install.sh | sh This installs the latest release on macOS or Linux, and it needs no account. Windows, npm and Cargo are below. Website · Documentation · Changelog · Contributing 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català A development build of 0.10.3, which is not released yet, with a scripted test model, in Full Access inside a throwaway workspace. The edit, three tests and a sub-agent review ran for real. Install The command above puts checksum-verified codewhale and its short alias codew in ~/.local/bin. If your shell then says command not found, follow the PATH note the installer prints (details). codewhale update upgrades it. bash winget install --id HunterBown.CodeWhale --exact --source winget Windows x64 npm install -g codewhale wraps the same release binaries cargo install codewhale-cli --locked builds from source; can trail GitHub Releases Prebuilt binaries cover Linux, macOS and Windows on x64 and arm64. Scoop, Nix, Homebrew on Linux, Android and Termux (preview) and manual downloads are in the installation guide, and containers are in Docker. Use one install method per machine; otherwise two copies end up on your PATH and whichever comes first wins. Quickstart 1. Commit or stash your work, then run codewhale from the root of a git repository. By default it applies file edits there without asking and asks before each shell command that is not read-only. 2. Run /provider (or press F3), pick a provider, paste its API key and choose a model. DeepSeek is the default provider. On a first launch with no key, Codewhale asks for a provider when you send your first message, and it offers a local model when a local Ollama server answers. 3. Type a task: text Fix the failing tests and explain what changed. Read-only commands run straight away. For any other shell command Codewhale asks first: y runs it once, a allows commands like it for the rest of the conversation, and n refuses. /undo takes back your last request and its file changes, and /help lists commands and keys. For scripts and CI, codewhale exec runs one task without the interface. Read headless runs before you give it tools with --auto, because --auto uses Full Access unless you add a sandbox. What it does Give Codewhale a task and it reads the repository, edits files and runs commands until the task is done or it needs your input. The latest release notes list the newest changes, and the changelog has every version. Any model More than 40 providers are built i
Top issues
#5316EPIC-005: CodeWhale TUI Crate Decomposition (Umbrella)36 comments · 2026-08-10#7095Conversation history is lost.12 comments · 2026-10-26#6184Engine silently freezes mid-run: user messages are persisted but never answered; no error, no log line, no crash entry10 comments · 2026-09-15#6011feat(tui): usage & tool diagnostics — token accounting (per-component, per-model + cache hit rate, per-tool sinks, compaction cost) and tool-call error patterns10 comments · 2026-09-08#5587Dead-code sweep: remove 25 module-level blanket allows and remaining allow(dead_code) in crates/tui9 comments · 2026-08-23#6050[Feature] Pluggable agent memory: a generic backend seam with causal-memory / mem0 as reference implementations8 comments · 2026-09-11#5586Decompose the mega files: runtime_threads.rs, lib.rs, runtime_api.rs, config.rs8 comments · 2026-08-23#6804号召:成立汉化组(Call to Action: Form a Chinese Localization Group)7 comments · 2026-10-01
Discussions
#7329🏆 Codewhale earned Repocharts Bronze: 10 days in GitHub Dev Tools0 comments · 2026-11-13#7327Medical Billing Services in Delaware | Acuity Health Solutions0 comments · 2026-11-12#7145Are you considering adding a nightly release?1 comments · 2026-10-29#6994CodeWhale is included in the AgentManager tool catalog0 comments · 2026-10-16#6808You won Repository Radar's Understory of the Month 🦀2 comments · 2026-10-01#6785号召:成立汉化组(Call to Action: Form a Chinese Localization Group)2 comments · 2026-09-30#6010Long-running agent turn stops before executing its explicitly stated next tool action and requires manual “continue”2 comments · 2026-09-08#6005Just a little update4 comments · 2026-09-07
Latest release
Codewhale v0.10.2 v0.10.2 2026-10-24What's in v0.10.2 Codewhale v0.10.2 adds an animated pet view (/pet on), a live Terminal work dock, per-chat composer colors (/color) and a one-time note on the first start after an update that says what changed. It closes three session data-loss paths and a codewhale web session leak; adds the default Runtime daemon socket locations to the sandbox deny-list; holds a curl or wget that uploads a credential; refuses shell commands containing invisible Unicode; keeps the Linux sandbox working when a hidden credential directory is a symlink; and reduces idle TUI redraw work. /undo takes back a w