CodeWhale

Codewhale

Codewhale is an open source coding agent for your terminal, built in Rust and improved in public with the people who use it.

[简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)

[](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) [](https://crates.io/crates/codewhale-cli) [](https://www.npmjs.com/package/codewhale) [](https://discord.gg/37gfS3ksug)

Install

npm install -g codewhale
codewhale

The first run helps you connect a provider or stay offline. Codewhale also supports Cargo, Docker, Nix, Scoop, prebuilt archives, Android/Termux, and a CNB mirror. See [the installation guide](docs/INSTALL.md).

Use

Talk to Codewhale the same way you would talk to a teammate:

Fix the failing tests and explain what changed.

Or run a task without opening the TUI:

codewhale exec "fix the failing tests and explain what changed"

Codewhale can read your repository, edit files, run commands, inspect results, and keep working toward a goal. You decide how much access it has.

Why Codewhale

• Use the model you want. Connect hosted providers or local models through

Ollama, vLLM, or SGLang. Switch provider and model with /model.

• Stay in control. Plan is read-only. Ask, Auto-Review, and Full Access make

approval behavior visible. /undo reverts the last turn and /restore returns the workspace to an earlier snapshot.

• Keep long work organized. Save sessions, set a durable /goal, review

workflows before they run, and coordinate agents without turning their internal instructions into your transcript.

• Extend the agent you already have. Connect MCP servers and skills,

configure hooks, and keep agent roles as readable files in your project or personal settings.

Run /help in the TUI for commands and keyboard shortcuts.

Safety

Codewhale runs on your machine with the access you grant it. Approval modes and repository rules limit what the agent may do; optional OS sandboxing adds a stronger execution boundary where supported. Unknown model prices stay unknown instead of being reported as free.

Read [authorization order](docs/AUTHORIZATION_ORDER.md) for the exact policy stack and [configuration](docs/CONFIGURATION.md) for local settings.

Documentation

• [Providers and local models](docs/PROVIDERS.md)
• [Agent teams](docs/FLEET.md)
• [MCP](docs/MCP.md), [hooks](docs/HOOKS.md), and [configuration](docs/CONFIGURATION.md)
• [Local web client](docs/WEB.md)
• [All documentation](docs)

Join the community

Codewhale gets better when people use it, report what feels wrong, and help fix it. If a provider is missing, a workflow is awkward, or the terminal UI gets in your way, open an issue. If you know how to improve it, [open a pull request](CONTRIBUTING.md). First contributions are welcome, and contributors keep credit for the work that lands.

Join the Discord, or add Hunter on WeChat (hunterbown) and ask to join the Whale Brothers group.

Project history

Codewhale began as deepseek-tui and still preserves that configuration and session compatibility. It is now provider-neutral and independently maintained; it is not affiliated with any model provider.

Thanks to every contributor and to the open source communities that helped the project grow. See [the contributor record](docs/CONTRIBUTORS.md).

License

[MIT](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Hmbown
• Source: Hmbown/CodeWhale
• License: MIT
• Homepage: https://codewhale.net/

Install and usage instructions live in the source repository linked above.