Hmbown /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
RustMITCreated 2026-01-19codewhale.net/
下载:Codewhale v0.10.2Codewhale-0.10.2 ↓0.10.22026-10-24
+3
日增长
+14
周增长
+101
月增长
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

Discussions

Latest release

Codewhale v0.10.2 v0.10.2 2026-10-24
What'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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON