codewhale-hq/CodewhalePublic

An open-source coding agent for your terminal, written in Rust. It works with any model, can split one task across several agents, and every line of it is yours to read.

AI summary: An open-source terminal coding agent that runs directly in your command line to modify codebases autonomously.

Stars
41.2K
+10 today
Forks
3.6K
Watchers
157
Open issues
68
Open PRs
9
Contributors
~252
Commits
14.6K
Branches
35
Views (30d)
5

RustMITCreated Jan 19, 2026Last push 2d agoLatest release v0.10.2+7 stars this week+80 this month

Quick answers

What is Codewhale?
An open-source terminal coding agent that runs directly in your command line to modify codebases autonomously.
What does Codewhale do?
CodeWhale is an interactive terminal coding agent designed to run seamlessly in the command line interface without managing heavy IDE extensions. It allows users to query and chat with LLMs while giving them the ability to natively run bash commands, read local files, write and edit code, and access tools over the internet via DuckDuckGo. The agent leverages Claude-3.5-Sonnet to orchestrate actions in an iterative feedback loop where it can read its environment, make changes, verify the outcome, and apply recursive solutions. The interface is highly optimized for terminal environments utilizing python-prompt-toolkit.
Who is Codewhale for?
Developers and system administrators who require a fast, headless terminal coding agent capable of autonomously interacting with local files and bash sessions. They can query LLMs and natively execute shell commands to modify their codebases. It is ideal for iterative feedback loops during development.
How do I get started with Codewhale?
pip install CodeWhale
How popular is Codewhale on GitHub?
codewhale-hq/Codewhale has 41,183 stars and 3,573 forks on GitHub, and gained 7 stars in the last 7 days.
What license does Codewhale use?
codewhale-hq/Codewhale is released under the MIT license.

Star history

since Jul 28, 2026
020K40KJul 2026Sep 2026Oct 2026Nov 2026
41.2K stars as of Nov 18, 2026. Measured daily since Jul 28, 2026; GitHub no longer exposes earlier star timestamps.

Update history

6 recorded
  • Nov 14, 2026Description changed from "Open-source agent for the terminal written in Rust. Use any provider or model. Issues & PRs always welcome" to "An open-source coding agent for your terminal, written in Rust. It works with any model, can split one task across sever".
  • Oct 28, 2026New release v0.10.2 (previously v0.10.1).
  • Oct 22, 2026Description changed from "Open-source Rust agent engine and terminal client for Codewhale, with provider choice, tools, approvals and receipts." to "Open-source agent for the terminal written in Rust. Use any provider or model. Issues & PRs always welcome".
  • Oct 17, 2026New release v0.10.1 (previously v0.10.0).
  • Oct 11, 2026Description changed from "Open-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues a" to "Open-source Rust agent engine and terminal client for Codewhale, with provider choice, tools, approvals and receipts.".
  • Oct 4, 2026Previously tracked as Hmbown/DeepSeek-TUI; its 1 daily snapshot and 16 trending appearances were merged into this profile. Stars: 40,198 on 2026-07-28 under the old name, 41,036 on 2026-10-03 (+838).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-16: 0 commits2025-11-17: 0 commits2025-11-18: 0 commits2025-11-19: 0 commits2025-11-20: 0 commits2025-11-21: 0 commits2025-11-22: 0 commits2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 21 commits2026-01-21: 6 commits2026-01-22: 5 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 4 commits2026-01-28: 16 commits2026-01-29: 9 commits2026-01-30: 3 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 4 commits2026-02-03: 20 commits2026-02-04: 0 commits2026-02-05: 8 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 6 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 24 commits2026-02-17: 10 commits2026-02-18: 18 commits2026-02-19: 21 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 5 commits2026-02-25: 2 commits2026-02-26: 10 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 4 commits2026-03-02: 10 commits2026-03-03: 6 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 6 commits2026-03-12: 12 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 5 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 2 commits2026-04-23: 6 commits2026-04-24: 26 commits2026-04-25: 80 commits2026-04-26: 125 commits2026-04-27: 85 commits2026-04-28: 65 commits2026-04-29: 7 commits2026-04-30: 11 commits2026-05-01: 52 commits2026-05-02: 56 commits2026-05-03: 123 commits2026-05-04: 112 commits2026-05-05: 80 commits2026-05-06: 108 commits2026-05-07: 84 commits2026-05-08: 109 commits2026-05-09: 84 commits2026-05-10: 149 commits2026-05-11: 75 commits2026-05-12: 146 commits2026-05-13: 44 commits2026-05-14: 31 commits2026-05-15: 8 commits2026-05-16: 8 commits2026-05-17: 5 commits2026-05-18: 14 commits2026-05-19: 2 commits2026-05-20: 2 commits2026-05-21: 26 commits2026-05-22: 0 commits2026-05-23: 52 commits2026-05-24: 71 commits2026-05-25: 21 commits2026-05-26: 98 commits2026-05-27: 52 commits2026-05-28: 32 commits2026-05-29: 32 commits2026-05-30: 60 commits2026-05-31: 102 commits2026-06-01: 104 commits2026-06-02: 57 commits2026-06-03: 114 commits2026-06-04: 69 commits2026-06-05: 87 commits2026-06-06: 41 commits2026-06-07: 55 commits2026-06-08: 23 commits2026-06-09: 55 commits2026-06-10: 46 commits2026-06-11: 40 commits2026-06-12: 133 commits2026-06-13: 80 commits2026-06-14: 115 commits2026-06-15: 49 commits2026-06-16: 17 commits2026-06-17: 74 commits2026-06-18: 30 commits2026-06-19: 22 commits2026-06-20: 26 commits2026-06-21: 102 commits2026-06-22: 28 commits2026-06-23: 110 commits2026-06-24: 84 commits2026-06-25: 122 commits2026-06-26: 88 commits2026-06-27: 65 commits2026-06-28: 71 commits2026-06-29: 35 commits2026-06-30: 63 commits2026-07-01: 48 commits2026-07-02: 72 commits2026-07-03: 42 commits2026-07-04: 14 commits2026-07-05: 70 commits2026-07-06: 70 commits2026-07-07: 31 commits2026-07-08: 148 commits2026-07-09: 127 commits2026-07-10: 24 commits2026-07-11: 12 commits2026-07-12: 24 commits2026-07-13: 37 commits2026-07-14: 61 commits2026-07-15: 72 commits2026-07-16: 93 commits2026-07-17: 126 commits2026-07-18: 133 commits2026-07-19: 88 commits2026-07-20: 74 commits2026-07-21: 128 commits2026-07-22: 72 commits2026-07-23: 85 commits2026-07-24: 47 commits2026-07-25: 65 commits2026-07-26: 133 commits2026-07-27: 197 commits2026-07-28: 29 commits2026-07-29: 78 commits2026-07-30: 65 commits2026-07-31: 57 commits2026-08-01: 91 commits2026-08-02: 119 commits2026-08-03: 217 commits2026-08-04: 139 commits2026-08-05: 24 commits2026-08-06: 6 commits2026-08-07: 5 commits2026-08-08: 9 commits2026-08-09: 1 commit2026-08-10: 4 commits2026-08-11: 5 commits2026-08-12: 12 commits2026-08-13: 29 commits2026-08-14: 28 commits2026-08-15: 19 commits2026-08-16: 34 commits2026-08-17: 63 commits2026-08-18: 29 commits2026-08-19: 138 commits2026-08-20: 119 commits2026-08-21: 30 commits2026-08-22: 4 commits2026-08-23: 35 commits2026-08-24: 4 commits2026-08-25: 11 commits2026-08-26: 19 commits2026-08-27: 36 commits2026-08-28: 42 commits2026-08-29: 13 commits2026-08-30: 14 commits2026-08-31: 25 commits2026-09-01: 50 commits2026-09-02: 40 commits2026-09-03: 28 commits2026-09-04: 39 commits2026-09-05: 45 commits2026-09-06: 82 commits2026-09-07: 26 commits2026-09-08: 3 commits2026-09-09: 19 commits2026-09-10: 16 commits2026-09-11: 23 commits2026-09-12: 53 commits2026-09-13: 99 commits2026-09-14: 24 commits2026-09-15: 55 commits2026-09-16: 49 commits2026-09-17: 7 commits2026-09-18: 42 commits2026-09-19: 17 commits2026-09-20: 25 commits2026-09-21: 88 commits2026-09-22: 148 commits2026-09-23: 68 commits2026-09-24: 78 commits2026-09-25: 213 commits2026-09-26: 168 commits2026-09-27: 66 commits2026-09-28: 91 commits2026-09-29: 287 commits2026-09-30: 213 commits2026-10-01: 49 commits2026-10-02: 11 commits2026-10-03: 21 commits2026-10-04: 37 commits2026-10-05: 41 commits2026-10-06: 16 commits2026-10-07: 19 commits2026-10-08: 19 commits2026-10-09: 54 commits2026-10-10: 45 commits2026-10-11: 98 commits2026-10-12: 8 commits2026-10-13: 23 commits2026-10-14: 6 commits2026-10-15: 16 commits2026-10-16: 52 commits2026-10-17: 64 commits2026-10-18: 69 commits2026-10-19: 29 commits2026-10-20: 28 commits2026-10-21: 60 commits2026-10-22: 15 commits2026-10-23: 18 commits2026-10-24: 24 commits2026-10-25: 75 commits2026-10-26: 14 commits2026-10-27: 106 commits2026-10-28: 62 commits2026-10-29: 42 commits2026-10-30: 28 commits2026-10-31: 32 commits2026-11-01: 50 commits2026-11-02: 10 commits2026-11-03: 57 commits2026-11-04: 27 commits2026-11-05: 60 commits2026-11-06: 49 commits2026-11-07: 59 commits2026-11-08: 17 commits2026-11-09: 13 commits2026-11-10: 159 commits2026-11-11: 7 commits2026-11-12: 0 commits2026-11-13: 0 commits2026-11-14: 0 commits
11,982 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    41,183 stars

  • Very active

    11,982 commits in 52 weeks

  • Community-driven

    ~252 contributors

  • Well documented

    High community health score

  • Permissive license

    MIT

  • Continuous integration

    Automated checks passing

  • Repeat trending

    16 trending appearances

What Codewhale does

CodeWhale is an interactive terminal coding agent designed to run seamlessly in the command line interface without managing heavy IDE extensions. It allows users to query and chat with LLMs while giving them the ability to natively run bash commands, read local files, write and edit code, and access tools over the internet via DuckDuckGo. The agent leverages Claude-3.5-Sonnet to orchestrate actions in an iterative feedback loop where it can read its environment, make changes, verify the outcome, and apply recursive solutions. The interface is highly optimized for terminal environments utilizing python-prompt-toolkit.

Developers and system administrators who require a fast, headless terminal coding agent capable of autonomously interacting with local files and bash sessions. They can query LLMs and natively execute shell commands to modify their codebases. It is ideal for iterative feedback loops during development.

  • Terminal execution loop: Executes natively in the terminal without requiring heavy web interfaces or editor plugins.
  • Autonomous shell commands: Has the ability to automatically execute bash scripts and shell commands to explore its environment.
  • File reading and writing: Natively accesses local filesystem files to implement and refine code blocks.
  • Web search integration: Incorporates search functions utilizing the DuckDuckGo API to research solutions and verify bugs online.
  • Local memory and config: Persists AI interactions and configurations gracefully within local storage for continuity.

Where teams use it

Headless Server Maintenance

Administrators use the terminal agent over SSH sessions to parse confusing log files and suggest command line fixes.

Rapid Test Generation

Developers use the agent to write test cases and verify execution results iteratively without breaking terminal focus.

Unfamiliar Code Exploration

Engineers drop the agent into an unfamiliar directory structure and ask it to explain file connections or find specific logic.

Automated Debugging Workflows

Programmers allow the agent to repeatedly run compiler commands and autonomously read stack traces until it finds the root cause.

Getting started: pip install CodeWhale

README

main branch
Codewhale

An open-source coding agent for your terminal that works with any model.

Give Codewhale a task and it reads the repository, edits files, and runs commands until the task is done or it needs input from you. It works with more than 40 built-in providers, DeepSeek V4.1 Flash by default, and with models running on your own machine. /receipts lists the files it changed, the commands it ran, and the web and MCP calls it made.

CI crates.io npm License: MIT Discord

Website · Documentation · Changelog · Contributing

简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

A Codewhale terminal session

A 0.10.2 development build with a scripted test model, in Full Access inside a throwaway workspace. The edit, three tests and a sub-agent review ran for real.

Codewhale × OrcaRouter — +30% DeepSeek v4.1 Flash usage

View the Codewhale × OrcaRouter offer. Codewhale earns a referral fee from OrcaRouter.

Install

macOS and Linux:

curl -fsSL https://codewhale.net/install.sh | sh

The installer puts checksum-verified codewhale and its short alias codew in ~/.local/bin. If your shell then says command not found, run the PATH line the installer prints (details). codewhale update upgrades it. These commands install the latest release. This page follows main, so a feature marked with a version arrives in that release; the changelog lists what each release adds.

Windows, npm, Cargo, and other ways to install
winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # crates.io; can trail GitHub Releases

Prebuilt binaries cover Linux, macOS, and Windows on x64 and arm64. Nix, Homebrew on Linux, Android/Termux (preview), and manual downloads are in the installation guide, and containers in Docker. Stick to one install method per machine; otherwise two copies end up on PATH and whichever comes first wins.

Quickstart

  1. Commit or stash your work, then run codewhale from the root of a git repository. By default (Accept Edits) it edits files in the repository without asking and asks before each command; Shift+Tab steps the permission dial when you want it to ask more or less.
  2. Run /provider (or press F3), pick a provider, paste its API key, and choose a model. DeepSeek is the default provider. With no key, pick a local runtime instead. If no provider is configured and Ollama is already serving a chat model, Codewhale uses it automatically; from 0.10.2 it offers it when you send your first message.
  3. Type a task:
Fix the failing tests and explain what changed.

Read-only commands run straight away. For any other shell command Codewhale asks first: y runs it once, a allows commands like it for the rest of the conversation, n refuses. /undo takes back your last request and its file changes. /help lists commands and keys.

For scripts and CI, codewhale exec runs one task without the interface. By default, --auto uses Full Access: tools run without asking, shell commands have no Codewhale sandbox, and trust mode lets file tools write outside the workspace. Add --sandbox workspace-write to keep the shell sandbox and file-tool workspace restrictions, with trust mode off:

codewhale exec --auto --sandbox workspace-write "fix the failing tests and explain what changed"

Modes and permissions

A fresh install starts in Work mode with the Accept Edits permission. One dial switches both: Shift+Tab steps Ask → Accept Edits → Plan → Auto-Review → Full Access.

Switch with Options
Mode the Plan stop on Shift+Tab, or /mode Plan reads and searches but changes nothing. Work (every other stop) edits files and runs commands; start a goal with /goal when a request needs more than one turn.
Permission Shift+Tab Ask asks before every file edit and every shell command that is not read-only. Accept Edits applies file edits in your git repository without asking and still asks before commands. Auto-Review lets rules and a reviewer model approve routine calls and refuses high-risk ones; switch to Ask to approve those yourself. Full Access never asks, and commands can reach anything on this computer; repository rules and managed policy still apply.

See the modes and permissions guide for the details.

What it does

New in 0.10.2

  • /pet on turns your terminal into an animated whale that shows what the agent is doing, while the message box stays live. Its 980 particles spell the current step in English, Chinese or Japanese.
  • /workbar terminal shows the shells the agent is running as they run. Type into one, or press Ctrl+N for a shell of your own (macOS and Linux).
  • /undo takes back your whole last request in one step, including every file it changed, and /diff works in folders without Git.
  • When a plan is ready, Codewhale asks whether to start Work with Ask or Auto-Review, or keep planning.
  • /color gives each chat its own composer color, saved with the session.
  • web_search can use DeepSeek's new Search API: set [search] provider = "deepseek" with a DeepSeek key.
  • Outside Full Access, a curl or wget that would upload a credential never runs without your approval, and a command that hides invisible Unicode is refused. write no longer replaces a file the agent has not read, or one that changed after it read it.

Models

More than 40 providers are built in, including Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter, and xAI. Any OpenAI-compatible endpoint works, and so do local models through Ollama, vLLM, or SGLang. The default is DeepSeek's deepseek-flash, which DeepSeek moved to DeepSeek-V4.1-Flash-1017 on 2026-10-17; 0.10.1 runs it without an update (details).

/model switches models between turns, and /model auto picks one for each turn (/router sets up how). /turn inspect shows which model a turn used, what it cost and how long it took. codewhale auth chatgpt lets you use a ChatGPT plan instead of an API key (experimental). See Providers.

Receipts and undo

/receipts, or codewhale receipts --last after you quit, lists the files changed, commands run, web and MCP calls, agents started, approvals and who gave them, and failures. /undo takes back your last request and the files it changed, in one step and without trust mode. /restore rolls the whole workspace back to an earlier snapshot; because that overwrites later edits, it needs /trust on or Full Access. See Receipts.

Exec runs that offer tools are saved in every output format, so codewhale receipts --last works after exec --auto, including --json. Answer-only text and --json runs are saved only when resuming or when conversation compaction starts; use --output-format stream-json to always save them for receipts or exec --continue.

Longer work

/goal sets an objective that carries across turns. Codewhale can split work across sub-agents, run a fleet of agents, or follow a workflow checked into the repository.

Coming from another agent

Codewhale reads AGENTS.md on its own. Instruction files written for other tools, such as CLAUDE.md, .cursorrules, or .github/copilot-instructions.md, load only when you opt in with project_instruction_imports = ["claude"] (or "cursor", "cline", "windsurf", "copilot", "all") in your config; see config.example.toml. Codewhale warns when it finds one it did not load.

/import-claude prepares an import of your Claude Code settings and MCP servers for you to review. /plugin install accepts Claude Code plugins containing skills, commands, agent profiles, and MCP servers, and refuses plugins that need hooks or LSP servers (details).

Extensions

Connect MCP servers, add skills and plugins, and run hooks on session and tool events. Code mode (experimental, on by default) lets the model write one execute_tools program that calls several MCP and plugin tools; each call still meets your approval rules and keeps its receipt. The independently installed Computer Use plugin (experimental, macOS only) can observe and operate other apps. It stays off until you review its access and enable it (guide).

Ways to run it

Command What it does
codewhale The interactive terminal app
codewhale exec "…" One task without the interface. On its own it answers without using tools; --auto enables tools with Full Access by default, --sandbox workspace-write restricts them, and --output-format stream-json streams events as JSON
codewhale web A local web UI on 127.0.0.1 (guide)
codewhale review --pr N An advisory review of a GitHub pull request. The GitHub bot setup generates a pinned workflow for automatic reviews and @codewhale review, using your own model key and optional App identity
codewhale app-server --http The Runtime API, a local HTTP API for threads, events, approvals, and each turn's file changes
codewhale serve --acp The Agent Client Protocol over stdio, for editors such as Zed

The terminal app, exec, web, and the Runtime API share one engine (architecture). A community-maintained VS Code extension connects to it from the sidebar (source). A native desktop app built on the Runtime API is in development; it has no public download yet.

Cost and accounts

Codewhale is free and MIT licensed. With your own API key you pay the provider directly; local models need no key. The footer and /cost show what a session has cost when the price is known, and an unknown price is shown as unknown, never as free.

You don't need an account. Keys you add with /provider stay on your machine.

Safety and privacy

In Ask and Auto-Review, commands run in an OS sandbox where the system has one: Seatbelt on macOS, and bubblewrap on Linux when it is installed. Windows has no OS sandbox yet, and Full Access turns the sandbox off. Inside the sandbox, shell commands cannot read credential stores such as ~/.ssh, ~/.aws and .env files; from 0.10.2 the same rule covers terminal sessions and more file tools. /preview-request shows a redacted preview of the next request without sending it.

Telemetry is on by default. It sends aggregate counts (version and platform, session length and outcome, which built-in providers you used, feature and error counts) with a random install ID that rotates every 90 days, and never conversations, code, prompts, model names, file or repository names, or credentials. codewhale config set telemetry false turns it off. At startup Codewhale also checks GitHub for a new release; set CODEWHALE_NO_UPDATE_CHECK=1 to skip that. More in authorization order, sandboxing, and telemetry.

Documentation

Start here Reference
Installation Configuration
Providers and local models Architecture
Modes and permissions Runtime API
Keybindings Plugin authoring
GitHub PR review All documentation

Community

Codewhale is what it is because of its community, and all feedback is welcome: a bug, an idea, or something that looked or felt wrong. Open an issue for any of these; an issue is also the best place to start a new feature. Pull requests are welcome for fixes, translations, providers and planned work. The contributing guide shows where each kind of help goes, and the roadmap shows where the project is headed. Contributors keep credit for the work that lands, and the repository layout shows where things live.

Chat on Discord, or add the maintainer, Hunter, on WeChat (hunterbown) and ask to join the Whale Brothers group. Everyone is welcome.

History and license

Codewhale started as deepseek-tui and still reads that project's configuration and sessions. It is independently maintained and not affiliated with DeepSeek or any other model provider. Thanks to everyone who has contributed.

Codewhale contributors

MIT. Code adapted from other open-source projects is listed in the third-party notices.

View on GitHub

Recent activity

commits and pull requests

Recent open issues

view all

Discussions

all 72

Releases and announcements

140 total
  1. Codewhale v0.10.2v0.10.2Oct 24, 202627.1K downloads

    ## What's in v0.10.2 Codewhale v0.10.2 adds an animated pet view (`/pet on`), a live Terminal work dock, per-chat composer colors (`/color`) and a one-time note on the first start after an update that says what changed. It closes three session data-loss paths and a `codewhale web` session leak; adds the default Runtime daemon socket locations to the sandbox deny-list; holds a `curl` or `wget` that uploads a credential; refuses shell commands containing invisible Unicode; keeps the Linux sandbox working when a hidden credential directory is a symlink; and reduces idle TUI redraw work. `/undo` takes back a whole request, including long and multiline prompts. `exec --auto` explains its Full Access default, honors an explicitly stricter sandbox, and saves tool-enabled runs and their failure receipts. Local runtimes appear during onboarding, `/diff` works outside a Git repository, DeepSeek's Responses route no longer rejects replayed tool history, and contributor fixes improve token accounting, relay model lists, localized replies and Windows launcher guidance. Delegated work continues without model-invented turn or time caps, and independent workflow steps can continue after another

  2. v0.10.1v0.10.1Oct 8, 202630.8K downloads

    > **Codewhale** is the public product from Shannon Labs. The `codewhale` > command, npm package, and release-asset names remain lowercase technical > identifiers. The legacy npm package `deepseek-tui` is deprecated and > receives no further releases. Users coming from v0.8.x legacy `deepseek` / > `deepseek-tui` names should migrate with `docs/REBRAND.md`. ## Install ### Recommended — official GitHub release New macOS/Linux install (checksummed binaries from this release): ```bash curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.10.1" sh "$HOME/.local/bin/codewhale" --version ``` For Windows, use the matching installer or archive below. For an existing direct install, run `codewhale update`; it prints the executable path and keeps newer builds. If the install directory is occupied by a different build, use the fresh-directory migration in [the installation guide](https://github.com/codewhale-hq/CodeWhale/blob/main/docs/INSTALL.md). ### Secondary packaging — npm and Cargo ```bash npm install -g codewhale # or build from source cargo install codewhale-cli --locked ``` The wrapper downloads the matched `codewhale` and `codew` command assets from this Release.

  3. v0.10.0v0.10.0Sep 22, 202625.1K downloads

    > **Codewhale** is the public product from Shannon Labs. The `codewhale` > command, npm package, and release-asset names remain lowercase technical > identifiers. The legacy npm package `deepseek-tui` is deprecated and > receives no further releases. Users coming from v0.8.x legacy `deepseek` / > `deepseek-tui` names should migrate with `docs/REBRAND.md`. ## Install ### Recommended — official GitHub release New macOS/Linux install (checksummed binaries from this release): ```bash curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.10.0" sh "$HOME/.local/bin/codewhale" --version ``` For Windows, use the matching installer or archive below. For an existing direct install, run `codewhale update`; it prints the executable path and keeps newer builds. If the install directory is occupied by a different build, use the fresh-directory migration in [the installation guide](https://github.com/Hmbown/CodeWhale/blob/main/docs/INSTALL.md). ### Secondary packaging — npm and Cargo ```bash npm install -g codewhale # or build from source cargo install codewhale-cli --locked ``` The wrapper downloads the matched `codewhale` and `codew` command assets from this Release. Both

  4. v0.9.13v0.9.13Sep 14, 202621K downloads

    > **Codewhale** is the public product from Shannon Labs. The `codewhale` > command, npm package, and release-asset names remain lowercase technical > identifiers. The legacy npm package `deepseek-tui` is deprecated and > receives no further releases. Users coming from v0.8.x legacy `deepseek` / > `deepseek-tui` names should migrate with `docs/REBRAND.md`. ## Install ### Recommended — official GitHub release New macOS/Linux install (checksummed binaries from this release): ```bash curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.9.13" sh "$HOME/.local/bin/codewhale" --version ``` For Windows, use the matching installer or archive below. For an existing direct install, run `codewhale update`; it prints the executable path and keeps newer builds. If the install directory is occupied by a different build, use the fresh-directory migration in [the installation guide](https://github.com/Hmbown/CodeWhale/blob/main/docs/INSTALL.md). ### Secondary packaging — npm and Cargo ```bash npm install -g codewhale # or build from source cargo install codewhale-cli --locked ``` The wrapper downloads the matched `codewhale` and `codew` command assets from this Release. Both

  5. v0.9.12v0.9.12Sep 5, 202617.2K downloads

    > **Codewhale** is the public product from Shannon Labs. The `codewhale` > command, npm package, and release-asset names remain lowercase technical > identifiers. The legacy npm package `deepseek-tui` is deprecated and > receives no further releases. Users coming from v0.8.x legacy `deepseek` / > `deepseek-tui` names should migrate with `docs/REBRAND.md`. ## Install ### Recommended — official GitHub release New macOS/Linux install (checksummed binaries from this release): ```bash curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.9.12" sh "$HOME/.local/bin/codewhale" --version ``` For Windows, use the matching installer or archive below. For an existing direct install, run `codewhale update`; it prints the executable path and keeps newer builds. If the install directory is occupied by a different build, use the fresh-directory migration in [the installation guide](https://github.com/Hmbown/CodeWhale/blob/main/docs/INSTALL.md). ### Secondary packaging — npm and Cargo ```bash npm install -g codewhale # or build from source cargo install codewhale-cli --locked ``` The wrapper downloads the matched `codewhale` and `codew` command assets from this Release. Both

Commits per week

last 52 weeks
7880Week of 2025-11-16: 0 commitsWeek of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 32 commitsWeek of 2026-01-25: 32 commitsWeek of 2026-02-01: 32 commitsWeek of 2026-02-08: 6 commitsWeek of 2026-02-15: 73 commitsWeek of 2026-02-22: 17 commitsWeek of 2026-03-01: 20 commitsWeek of 2026-03-08: 18 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 0 commitsWeek of 2026-03-29: 0 commitsWeek of 2026-04-05: 5 commitsWeek of 2026-04-12: 0 commitsWeek of 2026-04-19: 114 commitsWeek of 2026-04-26: 401 commitsWeek of 2026-05-03: 700 commitsWeek of 2026-05-10: 461 commitsWeek of 2026-05-17: 101 commitsWeek of 2026-05-24: 366 commitsWeek of 2026-05-31: 574 commitsWeek of 2026-06-07: 432 commitsWeek of 2026-06-14: 333 commitsWeek of 2026-06-21: 599 commitsWeek of 2026-06-28: 345 commitsWeek of 2026-07-05: 482 commitsWeek of 2026-07-12: 546 commitsWeek of 2026-07-19: 559 commitsWeek of 2026-07-26: 650 commitsWeek of 2026-08-02: 519 commitsWeek of 2026-08-09: 98 commitsWeek of 2026-08-16: 417 commitsWeek of 2026-08-23: 160 commitsWeek of 2026-08-30: 241 commitsWeek of 2026-09-06: 222 commitsWeek of 2026-09-13: 293 commitsWeek of 2026-09-20: 788 commitsWeek of 2026-09-27: 738 commitsWeek of 2026-10-04: 231 commitsWeek of 2026-10-11: 267 commitsWeek of 2026-10-18: 243 commitsWeek of 2026-10-25: 359 commitsWeek of 2026-11-01: 312 commitsWeek of 2026-11-08: 196 commitsNov 16, 2025Nov 8, 2026
12K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 129 commitsSun 1:00 — 99 commitsSun 2:00 — 84 commitsSun 3:00 — 61 commitsSun 4:00 — 55 commitsSun 5:00 — 55 commitsSun 6:00 — 45 commitsSun 7:00 — 36 commitsSun 8:00 — 35 commitsSun 9:00 — 49 commitsSun 10:00 — 58 commitsSun 11:00 — 70 commitsSun 12:00 — 98 commitsSun 13:00 — 87 commitsSun 14:00 — 108 commitsSun 15:00 — 120 commitsSun 16:00 — 111 commitsSun 17:00 — 100 commitsSun 18:00 — 76 commitsSun 19:00 — 92 commitsSun 20:00 — 61 commitsSun 21:00 — 93 commitsSun 22:00 — 78 commitsSun 23:00 — 60 commitsMon 0:00 — 72 commitsMon 1:00 — 63 commitsMon 2:00 — 80 commitsMon 3:00 — 66 commitsMon 4:00 — 53 commitsMon 5:00 — 59 commitsMon 6:00 — 33 commitsMon 7:00 — 19 commitsMon 8:00 — 20 commitsMon 9:00 — 35 commitsMon 10:00 — 51 commitsMon 11:00 — 54 commitsMon 12:00 — 50 commitsMon 13:00 — 40 commitsMon 14:00 — 46 commitsMon 15:00 — 54 commitsMon 16:00 — 81 commitsMon 17:00 — 57 commitsMon 18:00 — 66 commitsMon 19:00 — 78 commitsMon 20:00 — 86 commitsMon 21:00 — 94 commitsMon 22:00 — 144 commitsMon 23:00 — 115 commitsTue 0:00 — 113 commitsTue 1:00 — 85 commitsTue 2:00 — 61 commitsTue 3:00 — 54 commitsTue 4:00 — 63 commitsTue 5:00 — 33 commitsTue 6:00 — 40 commitsTue 7:00 — 49 commitsTue 8:00 — 42 commitsTue 9:00 — 56 commitsTue 10:00 — 96 commitsTue 11:00 — 90 commitsTue 12:00 — 72 commitsTue 13:00 — 94 commitsTue 14:00 — 85 commitsTue 15:00 — 85 commitsTue 16:00 — 122 commitsTue 17:00 — 102 commitsTue 18:00 — 128 commitsTue 19:00 — 99 commitsTue 20:00 — 116 commitsTue 21:00 — 150 commitsTue 22:00 — 112 commitsTue 23:00 — 139 commitsWed 0:00 — 110 commitsWed 1:00 — 126 commitsWed 2:00 — 88 commitsWed 3:00 — 76 commitsWed 4:00 — 52 commitsWed 5:00 — 58 commitsWed 6:00 — 49 commitsWed 7:00 — 39 commitsWed 8:00 — 61 commitsWed 9:00 — 44 commitsWed 10:00 — 77 commitsWed 11:00 — 72 commitsWed 12:00 — 94 commitsWed 13:00 — 66 commitsWed 14:00 — 59 commitsWed 15:00 — 75 commitsWed 16:00 — 76 commitsWed 17:00 — 80 commitsWed 18:00 — 68 commitsWed 19:00 — 72 commitsWed 20:00 — 97 commitsWed 21:00 — 82 commitsWed 22:00 — 95 commitsWed 23:00 — 103 commitsThu 0:00 — 95 commitsThu 1:00 — 60 commitsThu 2:00 — 69 commitsThu 3:00 — 66 commitsThu 4:00 — 46 commitsThu 5:00 — 36 commitsThu 6:00 — 50 commitsThu 7:00 — 27 commitsThu 8:00 — 42 commitsThu 9:00 — 39 commitsThu 10:00 — 32 commitsThu 11:00 — 54 commitsThu 12:00 — 62 commitsThu 13:00 — 61 commitsThu 14:00 — 92 commitsThu 15:00 — 93 commitsThu 16:00 — 110 commitsThu 17:00 — 80 commitsThu 18:00 — 88 commitsThu 19:00 — 71 commitsThu 20:00 — 94 commitsThu 21:00 — 63 commitsThu 22:00 — 62 commitsThu 23:00 — 91 commitsFri 0:00 — 95 commitsFri 1:00 — 125 commitsFri 2:00 — 103 commitsFri 3:00 — 60 commitsFri 4:00 — 48 commitsFri 5:00 — 70 commitsFri 6:00 — 41 commitsFri 7:00 — 20 commitsFri 8:00 — 44 commitsFri 9:00 — 37 commitsFri 10:00 — 62 commitsFri 11:00 — 70 commitsFri 12:00 — 52 commitsFri 13:00 — 54 commitsFri 14:00 — 76 commitsFri 15:00 — 86 commitsFri 16:00 — 62 commitsFri 17:00 — 41 commitsFri 18:00 — 54 commitsFri 19:00 — 70 commitsFri 20:00 — 57 commitsFri 21:00 — 154 commitsFri 22:00 — 87 commitsFri 23:00 — 68 commitsSat 0:00 — 55 commitsSat 1:00 — 78 commitsSat 2:00 — 54 commitsSat 3:00 — 49 commitsSat 4:00 — 71 commitsSat 5:00 — 48 commitsSat 6:00 — 41 commitsSat 7:00 — 27 commitsSat 8:00 — 29 commitsSat 9:00 — 36 commitsSat 10:00 — 53 commitsSat 11:00 — 42 commitsSat 12:00 — 40 commitsSat 13:00 — 69 commitsSat 14:00 — 34 commitsSat 15:00 — 33 commitsSat 16:00 — 54 commitsSat 17:00 — 65 commitsSat 18:00 — 64 commitsSat 19:00 — 99 commitsSat 20:00 — 56 commitsSat 21:00 — 74 commitsSat 22:00 — 74 commitsSat 23:00 — 116 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
May 18, 2026daily#22+44
May 17, 2026daily#22+96
May 16, 2026daily#22+108
May 15, 2026daily#17+69
May 14, 2026daily#7+105
May 13, 2026daily#10+86
May 12, 2026daily#9+69
May 11, 2026daily#10+146
May 10, 2026daily#15+183
May 9, 2026daily#8+223
May 8, 2026daily#2+265
May 7, 2026daily#1+435
May 6, 2026daily#1+492
May 5, 2026daily#2+272
May 4, 2026daily#6+203
  • public-apis/public-apis

    A collective list of free APIs

    500.5K stars · Python

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • NousResearch/hermes-agent

    The agent that grows with you

    265K stars · Python

  • n8n-io/n8n

    Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

    211.6K stars · TypeScript

  • yt-dlp/yt-dlp

    A feature-rich command-line audio/video downloader

    209.4K stars · Python