The open-source coding agent for any model

/pet on

Turns your terminal into an animated whale that shows what the agent is doing. The message box stays live.

/workbar terminal

Shows the shells the agent is running as they run. Type into one, or press Ctrl+N for your own. macOS and Linux.

/undo

Takes back your whole last request in one step, including every file it changed.

Plan → Work

When a plan ends with open steps, Codewhale asks whether to start Work with Ask or Auto-Review, or keep planning.

curl / wget

Outside Full Access, a curl or wget that would upload a credential never runs without your approval.

DeepSeek Search

web_search can use DeepSeek's new Search API: set [search] provider = "deepseek" with a DeepSeek key.

Build apps and tools

Create an app, add a feature or write a script. Codewhale can work through the project files, run the code and test what it builds. Docs

Automate the work you repeat

Run workflows from your terminal, scripts or CI. For larger tasks, delegate parts of the work to a Fleet of agents with different models. Docs

Connect the tools you use

Add tools through plugins and MCP servers, or use APIs from your own scripts. Each service needs its own setup and authentication. Docs

Your API accounts

Connect providers such as DeepSeek, OpenAI, Anthropic or Google with your own keys. The default, deepseek-flash, now runs DeepSeek-V4.1-Flash.

Your gateway

Use an OpenAI-compatible endpoint and choose the models it serves.

Your inference

Run local or self-hosted models with Ollama, vLLM or SGLang.

Your ChatGPT plan

Sign in with codewhale auth chatgpt to use a ChatGPT plan instead of an API key. Experimental.

Files and terminal

Create files, run commands, inspect data and test what you build. You set the working folder and permissions.

Plugins and connected apps

Add skills and tools through plugins and MCP. Review and enable the connections you want the agent to use.

Browser and computer · preview

Use browser tools and the Computer Use plugin for work in apps and websites, with the access you grant.

Sessions you can return to

Keep the conversation, tool results and work history together. Resume the task in the terminal or its local browser client.

Teams of agents

Use Fleet to split a larger job between agents with different roles and models, and follow their progress in one place.

Terminal and local browser

ReleasedInstall on Linux, macOS, or Windows, then run codewhale, or codewhale web for the local browser client. npm and Cargo also work; Android on Termux is a preview.

CodeWhale GUI (VS Code)

AvailableA separate, community-maintained project: chat, threads, and file changes in a VS Code sidebar over the same Codewhale Runtime. Install it from the VS Code Marketplace.

Hosted web app

In developmentBeing rebuilt to match the desktop app, and not open yet. For a browser view today, run codewhale web on your machine.

Desktop

Development buildA native app on the same engine. Review and commit changes, follow work across projects, and edit a message to resend it as a new branch. No public download yet.

The terminal, local browser, and GUI need no Codewhale account. When you use your own provider key, your provider bills that usage.