Repolode
Submit
codewhale-hq

codewhale-hq/Codewhale

Open-source Rust coding agent for the terminal that edits files, runs commands and works with 40+ model providers, including local models.

Open-source alternative to:Claude CodeCursor

View on GitHubWebsite
Stars
41,103
Forks
3,570
Open issues
205
Last commit
20 hours ago

What is it?

Codewhale is a coding agent that runs in your terminal. Given a task, it reads the repository, edits files and runs shell commands until the task is done or it needs your input. It ships with more than 40 built-in providers, including Anthropic, OpenAI, DeepSeek, Google, Mistral and OpenRouter, and it can also use any OpenAI-compatible endpoint or local models served through Ollama, vLLM or SGLang.

By default, shell commands other than read-only ones wait for your approval, and two modes (Plan, Work, Operate) plus three permission levels (Ask, Auto-Review, Full Access) control how much the agent can do on its own. The /receipts command lists the files changed, commands run, and web and MCP calls made, and /undo reverts the last request's file changes.

The same engine powers the interactive terminal app, a non-interactive exec mode for scripts and CI, a local web UI, a PR review command, a local HTTP Runtime API and an Agent Client Protocol server for editors. It supports MCP servers, skills, plugins and hooks.

Key features

  • 01Works with 40+ built-in model providers and any OpenAI-compatible endpoint
  • 02Supports local models through Ollama, vLLM and SGLang
  • 03Asks before running non-read-only shell commands, with Ask, Auto-Review and Full Access permission levels
  • 04Records a receipt of files changed, commands run and external calls
  • 05Undoes the last request's file changes with /undo
  • 06Connects MCP servers, skills, plugins and hooks

Use cases

  • Fixing failing tests or making multi-file changes in a git repository from the terminal
  • Running coding tasks non-interactively in scripts or CI with codewhale exec
  • Reviewing a GitHub pull request with an advisory review command
  • Using a locally hosted model so code stays on your machine

Quick start

  1. 1

    Install with the official install script from the README

  2. 2

    Install via npm

    npm install -g codewhale
  3. 3

    Run codewhale from the root of a git repository

    codewhale
  4. 4

    Run /provider to pick a provider and paste its API key, then type a task

Things to know

  • Windows has no OS sandbox yet, and Full Access turns the sandbox off.
  • Telemetry is on by default and can be turned off with a config command.
  • The bundled Computer Use plugin is experimental and macOS only.
  • Some features are merged on main but not yet in a published release.

Topics

#ai-agent#coding-agent#cli#terminal#rust#multi-model#mcp#local-first#agent-orchestration#codewhale

FAQ

What is Codewhale?
Open-source Rust coding agent for the terminal that edits files, runs commands and works with 40+ model providers, including local models. Codewhale is a coding agent that runs in your terminal. Given a task, it reads the repository, edits files and runs shell commands until the task is done or it needs your input. It ships with more than 40 built-in providers, including Anthropic, OpenAI, DeepSeek, Google, Mistral and OpenRouter, and it can also use any OpenAI-compatible endpoint or local models served through Ollama, vLLM or SGLang.
Is Codewhale free to use? What license does it have?
Codewhale is open source under the MIT license. Check the license terms before using it in commercial products.
Is Codewhale still maintained?
Actively maintained. The last commit to Codewhale was on Oct 19, 2026.
What can I use Codewhale for?
Fixing failing tests or making multi-file changes in a git repository from the terminal Running coding tasks non-interactively in scripts or CI with codewhale exec Reviewing a GitHub pull request with an advisory review command Using a locally hosted model so code stays on your machine
How do I install Codewhale?
Install with the official install script from the README Install via npm: npm install -g codewhale Run codewhale from the root of a git repository: codewhale Run /provider to pick a provider and paste its API key, then type a task
Where can I get Codewhale?
The source code and installation instructions are on GitHub: https://github.com/codewhale-hq/Codewhale

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects