Codewhale

codewhale-hq/Codewhale is an open-source project by codewhale-hq: Open-source Rust agent engine and terminal client for Codewhale, with provider choice, tools, approvals and receipts.. Indexed here so it can be found — not resold.

It is free. Get it from the upstream repository: https://github.com/codewhale-hq/Codewhale

From the project's own README (excerpt, reproduced for discovery under its MIT license):

An open-source coding agent for your terminal that works with any model.

Give Codewhale a task and it reads the repository, edits files, and runs commands until the task is done or it needs input from you. It works with more than 40 built-in providers, DeepSeek V4.1 Flash by default, and with models running on your own machine. /receipts lists the files it changed, the commands it ran, and the web and MCP calls it made.

Website · Documentation · Changelog · Contributing

简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

A 0.10.2 development build 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

macOS and Linux:

The installer puts checksum-verified codewhale and its short alias codew in ~/.local/bin. If your shell then says command not found, run the PATH line the installer prints (details). codewhale update upgrades it. These commands install the latest release. This page follows main, so a feature marked with a version arrives in that release; the changelog lists what each release adds.

Windows, npm, Cargo, and other ways to install

Prebuilt binaries cover Linux, macOS, and Windows on x64 and arm64. Nix, Homebrew on Linux, Android/Termux (preview), and manual downloads are in the installation guide, and containers in Docker. Stick to one install method per machine; otherwise two copies end up on 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 shows you the diff. 2. Run…