Tools/Hmbown/CodeWhale

CodeWhale

DeepSeek + MiMo coding agent in terminal

40.9k+26/wkgrowthRustMIT Licensetrending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Aug 2026

CodeWhale is an AI coding agent that lives in your terminal. You talk to it, and it reads, writes, and runs code in your project, with approval gates so it can't run wild. The twist that sets it apart: it's built first around open models like DeepSeek V4 rather than Claude or GPT, which makes it the budget-conscious option in a category dominated by frontier-model tools. The agent itself is MIT licensed and free, and it's one of the fastest-moving projects in this space right now.

It's a serious piece of engineering, not a wrapper. Three modes (Plan is read-only, Agent gates every action, YOLO auto-approves), side-git snapshots so you can roll back anything it changed without touching your real history, parallel sub-agents, and a rebuilt terminal interface that landed in the 0.9 series along with a web client. Providers now go well past DeepSeek: Mistral, Grok, and OpenRouter-style routing are first class, and setting model to auto picks the tier per prompt. Install is one npm, Homebrew, or Docker command. If you scripted the old deepseek binary names, those shims are gone; the command is codewhale now.

The tool is free; the model usage is not. You bring your own key and pay the provider per token, and DeepSeek's pricing keeps the same agentic workflow at a fraction of frontier-model cost. Solo developers who want a Claude Code style agent without the premium bill: this is the move. The closest comparisons are Claude Code, Aider, and OpenAI's Codex CLI.

The catch is that you're betting on a young project that ships almost daily, and 0.9 proved it will replace whole subsystems between minor versions (the entire default interface, in that case). Its best economics also assume cheap open-model APIs stay cheap and available. If you want the absolute strongest coding model regardless of cost, the frontier tools still win.

Free vs Self-Hosted vs Paid

fully free

Free (the tool): MIT licensed and fully open source. Install via npm, Homebrew, or Docker. No paywall, no hosted tier, no seat fees.

Paid (the models): Bring your own API key. You pay the provider (DeepSeek, Mistral, xAI, OpenRouter, NVIDIA NIM, and others) per token. DeepSeek-first is the point: its per-token pricing is among the lowest of the major providers, so an agent that burns a lot of tokens stays affordable.

The trade: The same terminal-agent workflow as Claude Code or Aider, routed to cheaper open models. You give up frontier-model quality for a large cut in cost.

The agent is free and open source. You pay only for model usage, and routing it to DeepSeek keeps that bill low.

What to do by team size

Solo
free; bring a DeepSeek or Mistral key
Small team
free; per-token model spend is the only bill
Medium team
free; standardize provider keys and budgets
Large team
free tool, but frontier-model agents may justify their cost for the hardest work
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
90/100 · A+
Adoption27/30
Maintenance25/25
Community13/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

High adoption: 37,771 starsActive community: 3,250 forksCommunity discussions enabledNotable author: 1,241 followers

License: MIT License

Use freely, including commercial. Just keep the license.

Commercial use: ✓ Yes

About

Owner
Hunter Bown (User)
Stars
40,936
Forks
3,554

Explore Further

More tools in the directory