Skip to content
Agents tracked: 501 Releases (7d): 777 Agent status: no reported issuesSince last limit reset: Claude 10d · Codex 8d For AI agents: Markdown Updated Nov 21, 2026

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.

Terminal coding agents Open-source terminal coding agentOpen source · MITFree to start

Use it in: CLI Web app API / SDK Works with: MCP Local models Own API key Multi-agent Headless / CI

Price
Free
free tier available
Popularity
#25 in Terminal
Gid Score 29 / 100 · #167 of 255 ranked AI agents
Trend
Slowing down
downloads down 11.0% over 30 days · down 12.9% last week
Development
Updated recently
latest 0.10.2, 28d ago
Community
41.2K GitHub stars
4,169 package downloads a week

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

MakerCodeWhale
TypeOpen-source terminal coding agent
First releasedJanuary 2026
LicenseMIT
InterfacesCLI, Web app, API
PlatformsmacOS, Windows, Linux
Local modelsLocal runners such as Ollama, vLLM and SGLang, with no API key (docs)
Main languageRust
Open issues and PRs106

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.

Compare prices of all agents

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

Full monthly summary

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

npmnpm install -g codewhale

These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.

Compare CodeWhale with another agent

vs
# 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 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 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

0.10.2
  • 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.
0.10.1
  • 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
0.10.0
  • 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
0.9.13
  • 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
0.9.12
  • 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
0.9.11
  • 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

Token prices of Anthropic modelsnewest Anthropic model in each family, output price per 1M tokens
Anthropic OpusAnthropic SonnetAnthropic Haiku

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.

Downloads per daynpm, 7-day average 596/day
GitHub starsrunning total 41.2K
Website rankTranco list; a lower rank means more traffic #3,189,414

Download the raw daily series: codewhale.csv

Gid Score breakdown

Adoption14
Community67
Attention—
Momentum39

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

NumberLatest readingLast checked
Package downloadsNov 19, 2026Nov 21, 06:18 UTC
GitHub starsNov 21, 2026Nov 21, 06:26 UTC
Website rank (Tranco)Nov 20, 2026Nov 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:

AgentGid: #25 in Terminal Gid Score: 29/100 downloads: 4,169/week ▼11% 30d

[![AgentGid: #25 in Terminal](https://agentgid.com/badges/codewhale-rank.svg)](https://agentgid.com/agents/codewhale/)
[![Gid Score: 29/100](https://agentgid.com/badges/codewhale-score.svg)](https://agentgid.com/agents/codewhale/)
[![downloads: 4,169/week ▼11% 30d](https://agentgid.com/badges/codewhale-downloads.svg)](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.