CodeWhale
Open-source terminal coding agent that runs any model locally
CodeWhale is the pick for developers who want a local, model-agnostic coding agent with fine-grained control. The 45 provider routes, per-sub-agent routing, and sandboxing deliver pro-level flexibility. Skip it if you need a GUI or managed service—this is terminal-first, and new users must climb a learning curve.
Verified 7d ago · liveness 69/100 · cite: rightaichoice.com/tools/codewhale
- Developers needing a local, model-agnostic coding agent
- Open-model enthusiasts running local inference (Ollama, vLLM, SGLang)
- CLI-native users wanting terminal-first control
- Teams needing sandboxed, auditable agent execution
- Non-technical users expecting a GUI
- Those wanting a fully managed cloud solution
- Beginners intimidated by CLI configuration
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip CodeWhale if you need a graphical user interface, a fully managed cloud service, or you're not comfortable with command-line configuration and terminal-based workflows.
Running local models requires your own hardware (GPU/CPU) and VRAM, which can be a significant upfront investment.
CodeWhale is free and open-source (MIT licensed), costing you nothing for the software itself. You only pay for the models you use—either your own local compute or API fees from providers. Compared to managed coding assistants like GitHub Copilot (which charges per seat), CodeWhale's only recurring cost is model usage. For teams that already have API access or run local inference, it's effectively free. This makes it ideal for cost-conscious developers and startups, while enterprises may prefer
In short
CodeWhale — Open-source terminal coding agent that runs any model locally. Best for Developers needing a local, model-agnostic coding agent, Open-model enthusiasts running local inference (Ollama, vLLM, SGLang), CLI-native users wanting terminal-first control. Free to use.
What's new in CodeWhale
Checked 7 days agoAcross the latest 2 updates: 1 feature update and 1 changelog entry.
v0.8.66 released — per-sub-agent provider routing and more
Per-sub-agent provider routing, environment-level tool sandboxing for sub-agents, and fixed a UTF-8 cursor panic in Codex edit_file.
Docs updated with 40+ Markdown guides
Expanded documentation index to cover architecture, providers, MCP, skills, and fleet management across 40+ pages.
What people actually say about CodeWhale — is it worth it?
We ran a structured research pass across product reviews, community discussions, and post-purchase forum threads to surface the patterns vendors won't publish themselves. Below: the recurring strengths, the hidden costs people mention most, and the cohort that consistently regrets adopting this tool.
11 mentions across 2 sources (Hacker News, GitHub) · researched Jul 3, 2026.
- +Cost-saving by routing low-complexity tasks to cheaper models like DeepSeek Flash.
- +Completely free and open-source (MIT license) with no subscription required.
- +Works with any AI model, prioritizing open-source and local runtimes.
- +Autonomous multi-step task planning and self-correction on failures.
- +Sandboxed execution via macOS seatbelt, Linux landlock, and Windows containment.
- −Steep learning curve for non-terminal-savvy users due to TUI/CLI interface.
- −High number of open GitHub issues (295) indicates ongoing instability.
- −Active security hardening work suggests potential unresolved vulnerabilities.
- −Some users switch between tools frequently, implying lack of stickiness.
- −Documentation and onboarding could be improved for beginners.
- • Cost of AI model API usage if using cloud models (e.g., DeepSeek API fees)
- • Compute resources for local models (GPU recommended)
Viability Score
How well maintained and how widely used is CodeWhale? Built from what the vendor actually publishes (docs, changelog, tutorials, integrations, pricing), whether the site is live, and how much real users discuss it. How we calculate this
Last calculated: August 2026
How we score →Key Features
- Terminal TUI with Plan/Work/Operate modes
- Headless command execution via 'codewhale exec'
- Loopback-only web client
- Runtime API + MCP endpoints
- 45 provider routes including hosted, gateway, local
- Local model support via Ollama, vLLM, SGLang
- Per-sub-agent provider routing (v0.8.66+)
- Sandboxed execution via macOS seatbelt, Linux landlock
- Constitution-based agent identity with law trace
- Fleet/WhaleFlow durable multi-agent workflows
- Lifecycle hooks for pre/post tool execution
- One-line npm install (Node 18+)
- Cargo, Docker, Nix, Windows install options
- China mirrors (CNB, npmmirror)
- Docs updated with 40+ Markdown guides
About CodeWhale
CodeWhale is an open-source, MIT-licensed coding agent that lives in your terminal and runs entirely on your own machine. It reads your repository, plans multi-step tasks, edits files, runs its own checks, and stops when the job is done or it needs you. Built for developers who want control and privacy, CodeWhale keeps your code local—no third-party cloud. With 45 provider routes, you can bring any model—hosted, gateway, or local—and mix them per role. Explicit provenance fields and cost tracking (or 'unknown' when unavailable) keep every action auditable.
Behind the Verdict
CodeWhale is a powerful, open-source terminal-based coding agent that prioritizes local execution and model flexibility. Its core strength lies in its 45 provider routes, which let you use hosted models like OpenAI's GPT, Anthropic's Claude, or open-source models running locally via Ollama, vLLM, or SGLang. You can even mix models per role—using a cheaper model for sub-agents and a more powerful one for main tasks. The per-sub-agent provider routing (added in v0.8.66) gives you granular control over which model handles which part of a workflow. The sandboxing (macOS seatbelt, Linux landlock) and explicit permission postures (Plan/Work/Operate) make it safe for automated code changes. The Constitution-based agent identity is unique, allowing you to enforce coding standards and audit decisions via the law trace. For developers who value privacy and control, CodeWhale is excellent. However, it's not for non-technical users—there's a learning curve with CLI configuration, and the web client is loopback-only, so no cloud collaboration. If you want a managed solution or a GUI, look elsewhere.
Researching CodeWhale? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Real-world workflow fit
Concrete scenarios for the personas CodeWhale actually fits — and what changes day-one when you adopt it.
Refactoring a legacy codebase
Outcome: Install CodeWhale with npm, point it at a repo, and use the Plan mode to inspect the code. It creates a multi-step plan, then executes edits in Work mode with approval prompts. The agent runs tests and reports results, leaving the developer to review the diff.
Automating CI/CD pipeline tasks
Outcome: Use Fleet/WhaleFlow to define a durable workflow that runs tests, builds artifacts, and deploys to staging. Each step is sandboxed and auditable via the law trace, and the agent can be configured to use a specific model per sub-agent for cost optimization.
Enforcing coding standards across contributions
Outcome: Configure the constitution to encode project-specific guidelines. When a pull request comes in, CodeWhale can review the changes, check for compliance, and suggest fixes—all while logging the reasoning in the law trace for transparency.
Use Cases
- Automate refactoring and bug fixing across large codebases via multi-step planning
- Run code reviews and enforce coding standards with constitution-based agent guidance
- Execute complex CI/CD pipeline tasks using Fleet/WhaleFlow for durable orchestration
- Develop and test API integrations with MCP tools exposed over stdio or HTTP
- Build custom skill libraries for domain-specific coding assistance
- Use local models for fully offline code completion and analysis
Models Under the Hood
as of 2026-08-25
Limitations
- CodeWhale is a terminal-first open-source coding agent that runs any model locally and supports 45 provider routes, including hosted, gateway, and local providers.
- It requires Node 18+ for the one-line npm install, and offers a loopback-only web client (no public web UI).
- Advanced features such as sub-agents, sandboxing, and per-sub-agent provider routing require configuration and understanding of the architecture.
as of 2026-08-17
Verification history
We have re-verified CodeWhale 5 times since . Each pass re-reads the vendor's own pages and re-checks every listed field against that evidence; passes where nothing had changed are marked as such.
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
- — re-verified summary, description, our verdict, our analysis, pricing model, pricing tiers, features, integrations, who it suits, who should skip it
Free to cite with attribution — this page re-verifies continuously.
12-month cost
Project the real annual outlay, including the implied monthly cost when only an annual tier is published.
Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.
Plans compared
For each published CodeWhale tier: who it actually fits, and what it adds vs. the previous tier. Cross-reference the cost calculator above for projected annual outlay.
Open Source
$0/mo
Ideal for
Solo developers and open-source enthusiasts who want a free, local, model-agnostic coding agent and are willing to configure it via the terminal.
What this tier adds
Starting tier: free and MIT-licensed, includes all core features like terminal TUI, headless exec, web client, 45 provider routes, and sandboxing.
Where the pricing makes sense
The company stage and team size where CodeWhale's pricing actually pencils out — and where peers do it cheaper.
CodeWhale is free and open-source (MIT licensed), costing you nothing for the software itself. You only pay for the models you use—either your own local compute or API fees from providers. Compared to managed coding assistants like GitHub Copilot (which charges per seat), CodeWhale's only recurring cost is model usage. For teams that already have API access or run local inference, it's effectively free. This makes it ideal for cost-conscious developers and startups, while enterprises may prefer
Setup time & first value
How long it actually takes to get something useful out of CodeWhale — broken out by persona, not the marketing-page minute.
The one-line npm install (Node 18+) takes about 1 minute. First run: configure your model provider (e.g., add an API key or point to local Ollama), then start a session. You'll be productive within 15-30 minutes if you're comfortable with CLI tools. For advanced features like Fleet or custom sandboxing, expect 1-2 hours to fully configure.
Switching to or from CodeWhale
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From Other coding agents (e.g., Aider, OpenHands): CodeWhale offers a different architecture, but you can import your existing project and start fresh. There's no direct migration path, but you can reuse your model API
- →From GitHub Copilot: You can keep Copilot for interactive editing and use CodeWhale for autonomous tasks. No data migration needed—just install and configure.
- →From Cursor: Similar to Copilot, you can use CodeWhale side-by-side for terminal-based workflows.
- ↗To Other open-source agents (e.g., Aider, OpenHands): CodeWhale's MIT license means you can freely switch. Your project files and git history remain intact.
- ↗To Managed services (e.g., GitHub Copilot, Cursor): Your code and workflow data are local, so you can move without vendor lock-in, but you'll lose the local-first privacy.
- ↗To Cloud CI/CD (e.g., GitHub Actions): For automated tasks, you can replicate Fleet workflows as CI steps, though you'd need to rewrite the configuration.
Integrations
Resources & Guides
- Documentationcodewhale.net
Docs · CodeWhale
Full product docs from codewhale.net
- Documentationcodewhale.net
Configuration · CodeWhale
Full product docs from codewhale.net
- Documentationcodewhale.net
Vocabulary · CodeWhale
Full product docs from codewhale.net
- Documentationcodewhale.net
Constitution · CodeWhale
Full product docs from codewhale.net
- Documentationcodewhale.net
Modes · CodeWhale
Full product docs from codewhale.net
- Documentationcodewhale.net
Tools · CodeWhale
Full product docs from codewhale.net
Tutorials & Learning
Official links
Tools that pair well with CodeWhale
Common stack mates teams adopt alongside CodeWhale, with the specific reason each pairing earns its keep.
Featured Head-to-Head Comparisons
Codewhale vs Locus Robotics
These tools serve completely different domains: Locus Robotics is an industrial warehouse automation platform for physical fulfillment, while CodeWhale is a local terminal coding agent for software developers. Choose Locus if you need to boost warehouse picking productivity 2-3x with AMRs and RaaS; choose CodeWhale if you want a free, open-source, model-agnostic AI coding assistant that runs on your command line.
Codewhale vs Truleo
Buyers should not confuse these two tools — they serve entirely different domains. If you are a law enforcement agency looking to unify siloed data and automate investigative leads, Truleo is purpose-built for you. If you are a developer wanting a free, local, multi-model terminal coding agent, CodeWhale is the clear choice. They are not competitors but complementary in the broadest sense.
Codewhale vs Presto Voice
CodeWhale and Presto Voice serve completely different domains. CodeWhale is a free, open-source coding agent for developers who want local, model-agnostic automation. Presto Voice is an enterprise voice AI for QSR drive-thrus, with recent high-profile partnerships like Dairy Queen. Choose based on your industry: developers should pick CodeWhale; QSR operators should explore Presto Voice.
Alternatives to CodeWhale
View allFrequently Asked Questions
Categories
Used CodeWhale? Help shape our editorial sentiment research.