- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- Dhruv Singal / @dsingal0 — added Herdr agent state, session resume commands and pane release.
CodeWhale
A provider-neutral terminal coding agent written in Rust that reads projects, edits files, runs commands and tests to check its work, with approval-based permissions, undo and sub-agents. It grew out of the deepseek-tui project.
Use it in: CLI Web app API / SDK Works with: MCP Local models Own API key Multi-agent Headless / CI
On this page
Usage data: latest readings Nov 19 to Nov 21, 2026, last checked Nov 21, 06:29 UTC. Date of each number
What CodeWhale does
CodeWhale is an open-source terminal coding agent from CodeWhale, first released in January 2026. You use it through a command-line tool, a web app and an API on macOS, Windows and Linux. Its documentation covers MCP servers, subagents or parallel agents, a non-interactive mode for scripts and CI, your own API key and local models. It can run models from Anthropic, OpenAI, Google, xAI, Mistral and DeepSeek and others. It is free and open source (MIT); you pay only for the models it calls.
Key facts
| Maker | CodeWhale |
|---|---|
| Type | Open-source terminal coding agent |
| First released | January 2026 |
| License | MIT |
| Interfaces | CLI, Web app, API |
| Platforms | macOS, Windows, Linux |
| Local models | Local runners such as Ollama, vLLM and SGLang, with no API key (docs) |
| Main language | Rust |
| Open issues and PRs | 106 |
Pricing
Free and open source (MIT); users pay their chosen model provider directly or run local models.
Source: official pricing page, checked Oct 6, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?Yes (MIT)
- Works with local models?Yes
- Runs onmacOS, Windows, Linux
- Where you use itCLI, Web app, API
- Supports MCP?Yes
- Model providersanthropic, openai, google, xai, mistral, deepseek, moonshot, openrouter, any OpenAI-compatible, local
- Subagents / multi-agent?Yes
- Runs in scripts / CI?Yes
- Feature comparisonAll agents
- Closest alternativeClaude Code · all alternatives
What's new in CodeWhale: October 2026
October brought stability improvements and fixes for session handling and workspace management. Two releases addressed installation guidance, OAuth diagnostics, and platform-specific build issues.
- Session resuming through symlinks no longer produces false workspace-change warnings.
- Runtime clients can now read actual workspace changes and reviewed skill details from tool calls.
- Fixed Windows OpenHarmony CMake generator and CLI hashing-module build failures.
- OAuth retry diagnostics improved to omit provider-controlled error fields.
2 releases this month · summarised from the official release notes · all months
Get started with CodeWhale
| npm | npm install -g codewhale |
|---|
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
CodeWhale alternatives
Best CodeWhale alternatives compared · All terminal coding agents
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
Claude CodeAnthropic |
89 | 21.7M | up 25.9% | up 18.1% | 156K+142/day | 2.1.330yesterday | $20/mo | |||
| 2 |
OpenAI CodexOpenAI |
84 | 27.5M | up 4.1% | up 6.5% | 136K+131/day | 0.168.08d ago | Free + $8/mo | |||
| 3 |
OpenCodeAnomaly (SST team) |
80 | 3.9M | up 10.4% | up 24.2% | 228K+254/day | 2.3.23d ago | Free + $10/mo | |||
| 7 |
PiEarendil Inc. (created by Mario Zechner) |
72 | 6.6M | up 4.1% | up 33.1% | 123K+182/day | 1.6.0yesterday | Free (OSS) | |||
| 15 |
Gemini CLIGoogle |
63 | 522K | up 19.0% | up 7.1% | 109K+35/day | 0.70.02d ago | API usage or license | |||
| 20 |
ClineCline Bot Inc. |
58 | 82K | down 3.3% | up 9.8% | 71.8K+33/day | 4.1.27today | Free + $9.99/mo | |||
Ratings from people who use CodeWhale
No ratings yet. Used CodeWhale? Rate it and say what it is good and bad at.
What changed: recent CodeWhale releases
6 stable releases in the last 90 days · Monthly summary · Full changelog
- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- OAuth retry diagnostics omit provider-controlled error fields; account replacement stops before retired Weixin receipts exceed their storage limit, preserving uncertain work for local review.
Earlier releases
- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- Children never inherit desktop or computer-control tools. Desktop control is
- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- /pet turns the terminal over to the Codewhale pet. /pet on (or bare
- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- Computer use ships with the binary. The computer-use plugin — 38 tools
- For the installer path, run CodeWhaleSetup.exe; it installs
- Extract the archive for your machine: codewhale-windows-x64.zip or
- Double-click codewhale.bat (not the raw .exe) to launch
- Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin
- Add %USERPROFILE%\bin to your PATH
- Added first-party deepseek-v4-flash-vision-exp discovery and selection for
CodeWhale prices over time
CodeWhale popularity and usage data
CodeWhale was downloaded 4,169 times from npm in the week ending Nov 19, 2026, down 12.9% on the week before and down 11.0% over the last 30 days compared with the 30 before. The GitHub repository has 41.2K stars, 299 of them added in the last 30 days. The latest stable release is 0.10.2, published Oct 24, 2026; there was 1 stable release in the past 30 days.
Download the raw daily series: codewhale.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 19, 2026 | Nov 21, 06:18 UTC |
| GitHub stars | Nov 21, 2026 | Nov 21, 06:26 UTC |
| Website rank (Tranco) | Nov 20, 2026 | Nov 21, 06:29 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
CodeWhale FAQ
How much does CodeWhale cost?
Free and open source (MIT); users pay their chosen model provider directly or run local models.
Is CodeWhale open source?
Yes. CodeWhale is open source, released under the MIT license.
How popular is CodeWhale?
CodeWhale was downloaded 4,169 times from npm in the week ending Nov 19, 2026, down 12.9% on the week before and down 11.0% over the last 30 days compared with the 30 before. The GitHub repository has 41.2K stars, 299 of them added in the last 30 days. The latest stable release is 0.10.2, published Oct 24, 2026; there was 1 stable release in the past 30 days.
What is the latest version of CodeWhale?
The latest stable release we track is 0.10.2, published on Oct 24, 2026.
What are the alternatives to CodeWhale?
The closest alternatives in the same category by Gid Score are Claude Code, OpenAI Codex, OpenCode, Pi.
For the makers of CodeWhale badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/codewhale/)
[](https://agentgid.com/agents/codewhale/)
[](https://agentgid.com/agents/codewhale/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
npm: codewhale. GitHub: codewhale-hq/codewhale. Site rank: codewhale.net on the Tranco list. See data sources for how each one is collected.
Product facts and pricing were checked against: github.com, codewhale.net, registry.npmjs.org.