--- title: "CodeWhale" type: "tool" slug: "hmbown-codewhale" canonical_url: "https://www.graphcanon.com/tools/hmbown-codewhale" github_url: "https://github.com/Hmbown/CodeWhale" homepage_url: "https://codewhale.net/" stars: 39550 forks: 3409 primary_language: "Rust" license: "MIT" categories: ["developer-tools", "ai-agents"] tags: ["terminal", "tui", "deepseek", "llm", "rust", "cli"] updated_at: "2026-07-07T18:18:57.237397+00:00" --- # CodeWhale > Open-source, community-driven agent harness CodeWhale is a terminal coding agent built with Rust that works with various AI models and providers to assist in coding tasks through TUI/CLI interfaces. ## Facts - Repository: https://github.com/Hmbown/CodeWhale - Homepage: https://codewhale.net/ - Stars: 39,550 · Forks: 3,409 · Open issues: 333 · Watchers: 155 - Primary language: Rust - License: MIT - Last pushed: 2026-07-07T15:59:06+00:00 ## Categories - [Developer Tools](/categories/developer-tools.md) - [AI Agents](/categories/ai-agents.md) ## Tags terminal, tui, deepseek, llm, rust, cli ## Related tools - [ECC](/tools/affaan-m-ecc.md) - The agent harness performance optimization system (★ 226,962) - [hermes-agent](/tools/nousresearch-hermes-agent.md) - The self-improving AI agent built by Nous Research (★ 210,880) - [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT: Build, Deploy, and Run AI Agents (★ 185,417) - [ollama](/tools/ollama-ollama.md) - Get up and running with Kimi-K2.6, GLM-5.1, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models. (★ 175,659) - [prompts.chat](/tools/f-prompts-chat.md) - The world's largest open-source prompt library for AI (★ 165,019) - [JavaGuide](/tools/snailclimb-javaguide.md) - Snailclimb/JavaGuide: 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发 (★ 156,863) - [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful platform for building and deploying AI-powered agents and workflows. (★ 151,298) - [dify](/tools/langgenius-dify.md) - Production-ready platform for agentic workflow development (★ 148,070) ## README (excerpt) ```text # CodeWhale > The terminal coding agent for any model — open models first. CodeWhale is a terminal coding agent — a TUI and a CLI. You point it at a model and a project, and it gets to work: reading code, making edits, running commands, checking results, planning multi-step tasks, and correcting itself when something fails. It's open source (MIT, Rust), it runs on your machine, and it works with the models people actually use. DeepSeek and open-weight models are first-class, and a local vLLM/SGLang/Ollama box on your LAN needs no key at all — but Claude, GPT, Kimi, and GLM are full peers through the same runtime and the same tools. You pick a provider and a model; CodeWhale resolves a real route and runs. The project began as `deepseek-tui`, a coding harness built around DeepSeek workflows. The developer community — much of it in China — adopted it, filed reports, and contributed fixes, and it became clear the harness was bigger than one model. Multi-provider support followed, and the project became CodeWhale to match. If there's a model, endpoint, or feature you don't see that you want, open an issue — that's how the project grows. [简体中文 README](README.zh-CN.md) · [日本語 README](README.ja-JP.md) · [Tiếng Việt README](README.vi.md) · [한국어 README](README.ko-KR.md) · [codewhale.net](https://codewhale.net/) · [Install guide](docs/INSTALL.md) · [Provider registry](docs/PROVIDERS.md) · [Changelog](CHANGELOG.md) ## Install ```bash npm install -g codewhale codewhale --version # 0.8.67 ``` The npm wrapper (Node 18+) downloads SHA-256-verified binaries from GitHub Releases and installs `codewhale`, `codew`, and `codewhale-tui`. Prefer building from source? Use cargo (Rust 1.88+): ```bash cargo install codewhale-cli --locked cargo install codewhale-tui --locked ``` > **Linux users:** install system build dependencies first: > `sudo apt-get install -y build-essential pkg-config libdbus-1-dev`. > See [INSTALL.md](docs/INSTALL.md#4-install-via-cargo-any-tier-1-rust-target). Every other path: ```bash # Docker docker pull ghcr.io/hmbown/codewhale:latest # Nix nix run github:Hmbown/CodeWhale # Windows scoop install codewhale # or the NSIS installer from GitHub Releases # CNB mirror for users who cannot reliably reach GitHub cargo install --git https://cnb.cool/codewhale.net/codewhale --tag v0.8.67 codewhale-cli --locked --force cargo install --git https://cnb.cool/codewhale.net/codewhale --tag v0.8.67 codewhale-tui --locked --force # Legacy Homebrew compatibility while the formula is renamed brew tap Hmbown/deepseek-tui brew install deepseek-tui ``` Prebuilt archives for Linux x64/arm64, macOS x64/arm64, and Windows x64 are attached to [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases). Linux riscv64 prebuilts are temporarily paused while upstream QuickJS bindings catch up. Checksums, China mirrors, Windows specifics, and troubleshooting live in [docs/INSTALL.md](docs/INSTALL.md). **Upgrading from the legacy `deepseek-tui` package?** Your config, sessions, skills, and MCP settings are preserved. See [docs/REBRAND.md](docs/REBRAND.md), then run `codewhale doctor` to confirm. ## First run ```bash codewhale auth set --provider deepseek codewhale auth status codewhale doctor codewhale ``` Every provider is the same one-line shape: `--provider openrouter`, `--provider moonshot`, `--provider openmodel`, or point `vllm`, `sglang`, or `ollama` at your own localhost runtime with no key at all. Have a Claude key instead? Run `codewhale auth set --provider anthropic` — or just export `ANTHROPIC_API_KEY` — and the native Messages adapter takes it from there. Keys land in `~/.codewhale/config.toml`; legacy `~/.deepseek/` config is still read for compatibility. Useful in-session commands: - `/provider` opens the readiness dashboard — per provider it shows auth state, the resolved default route, and the cost/usage meter. `/model` picks the model and reasoning effort. Both also take arguments (`/provider ``` --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/tools/hmbown-codewhale`](/api/graphcanon/tools/hmbown-codewhale) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_