by codewhale-hq
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.
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
# Add to your Claude Code skills
git clone https://github.com/codewhale-hq/CodewhaleGuides for using ai agents skills like Codewhale.
Last scanned: 10/5/2026
{
"issues": [
{
"file": "README.md",
"line": 34,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://codewhale.net/install.sh | sh\"",
"severity": "low"
}
],
"status": "PASSED",
"scannedAt": "2026-10-05T11:12:04.854Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how Codewhale compares with popular alternatives.
Codewhale is 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.
curl -fsSL https://codewhale.net/install.sh | sh
This installs the latest release on macOS or Linux, and it needs no account. Windows, npm and Cargo are below.
Website · Documentation · Changelog · Contributing
简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català
A real session on a 0.10.3 development build: gemini-4-hydrogen through Google's API wrote the edit, and you allowed the test run once.
The command above puts checksum-verified codewhale and its short alias
codew in ~/.local/bin. If your shell then says command not found,
follow the PATH note the installer prints
(details). codewhale update upgrades
it.
winget install --id HunterBown.CodeWhale --exact --source winget # Windows x64
npm install -g codewhale # wraps the same release binaries
cargo install codewhale-cli --locked # builds from source; can trail GitHub Releases
Prebuilt binaries cover Linux, macOS and Windows on x64 and arm64. Scoop, Nix,
Homebrew on Linux, Android and Termux (preview) and manual downloads are in the
installation guide, and containers are in
Docker. Use one install method per machine; otherwise two
copies end up on your PATH and whichever comes first wins.
codewhale from the root of a git
repository. By default it applies file edits there without asking and asks
before each shell command that is not read-only./provider (or press F3), pick a provider, paste its API key and
choose a model. DeepSeek is the default provider. On a first launch with no
key, Codewhale asks for a provider when you send your first message, and it
offers a local model when a local Ollama server answers.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, and n refuses. /undo takes back your last request and its
file changes, and /help lists commands and keys.
For scripts and CI, codewhale exec runs one task without the interface. Read
headless runs before you give it tools
with --auto, because --auto uses Full Access unless you add a sandbox.
Give Codewhale a task and it reads the repository, edits files and runs commands until the task is done or it needs your input. The latest release notes list the newest changes, and the changelog has every version.
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
model is DeepSeek's deepseek-flash, which now serves DeepSeek V4.1 Flash
(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. See Providers.
/receipts, or codewhale receipts --last after you quit, lists the files a
session changed, the commands it ran, its web and MCP calls, the agents it
started, each approval and who gave it, and what failed. /undo takes back
your last request and the files it changed in one step. /restore rolls the
whole workspace back to an earlier snapshot, and because that overwrites later
edits it needs /trust on or Full Access. See Receipts.
/goal sets an objective that carries across turns. Codewhale can split work
across sub-agents, run a Fleet of agents
with their own roles and models, or follow a
workflow checked into the repository.
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. Computer Use
is a separate plugin released on its own (experimental, macOS only), and stays
off until you review its access and turn it on.
| Command | What it does |
|---|---|
codewhale |
The interactive terminal app |
codewhale exec "…" |
One task without the interface, for scripts and CI (headless runs) |
codewhale web |
A local web client on 127.0.0.1 (guide) |
codewhale review --pr N |
An advisory review of a GitHub pull request; the GitHub bot setup runs it on your own model key |
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).
Codewhale × OrcaRouter gives 30% extra DeepSeek V4.1 Flash credit on each OrcaRouter top-up until November 21, 2026. This link is part of a referral campaign; Codewhale may earn a referral reward on top-ups made through it.
Two switches say how much Codewhale may do on its own. Tab, when the input
is empty, changes the mode: Plan reads and searches but changes nothing,
Work edits files and runs commands, and Operate has the same access as
Work and keeps going until the goal is verified or it needs you. Shift+Tab
changes the permission. Ask, the default, applies file edits in your
repository without asking and asks before shell commands that are not
read-only.
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 turns off Codewhale's sandbox, although repository
rules and managed policy still apply. The
v0.10.2 guide
has the details.
Coming in 0.10.3: Shift+Tab becomes one dial through Ask, Accept Edits,
Plan, Auto-Review and Full Access, Tab no longer changes the mode, and
Operate is retired. Ask will ask before every file edit too, and the new
default, Accept Edits, will apply edits inside the git repository and still ask
before commands. The current guide describes it.
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 and terminal sessions cannot read credential stores
such as ~/.ssh, ~/.aws and .env files.
/preview-request shows a redacted preview of the next request without
Codewhale is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by codewhale-hq. 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. It has 41,182 GitHub stars.
Yes. Codewhale passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/codewhale-hq/Codewhale" and add it to your Claude Code skills directory (see the Installation section above).
Codewhale is primarily written in Rust. It is open-source under codewhale-hq on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Codewhale against similar tools.
No comments yet. Be the first to share your thoughts!
Based on votes and bookmarks from developers who liked this skill