Build apps and automate workflows

Codewhale is an open-source coding agent that reads files, writes code and runs commands in your terminal. Connect a hosted or local model and choose which actions need approval.

Install Codewhale Read the docs Можливості

Explore the terminal

Captured views from a Codewhale demo session. Explore the conversation, task workbar, model connections and help.

A follow-up message in the composer, ready to send.

▎ Local demo: add --json to export.py, run tests, and delegate a review.                                                                                                                               │╭ ✓ • tool done · 3/3 · 100%                                                                       ││ ▏ checklist: todo_write                                                                          ││ ▏ ☑ Inspect the export command                                                                   ││ ▏ ☑ Add the --json flag                                                                          │╰ ▏ ☑ Run tests and review the change                                                              │                                                                                                   │● JSON export is ready.                                                                            │▏                                                                                                  │▏ Added --json while preserving CSV output. All 3 local tests passed, and the delegated review     │▏ found no issues.                                                                                 ┃▏                                                                                                  ┃▏ Try: python3 export.py --json                                                                    ┃▏                                                                                                  ┃▏ This session uses the local website-demo provider.                                               ┃                                                                                                   ┃Note Workbar is off — no panel renders (/workbar bottom|top|left|right to show it)                 ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Also cover an empty export.                                                                     ││                                                                                              [↵] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access  Shift+Tab to change   work (Tab)   Work bar (Ctrl+]) Command selected: /workbar off  website-demo · website-demo   context 7%

What you can build and automate

See every provider

Build apps and useful tools

Create a new application, extend a project, turn data into a report, or write a script that saves you time. The agent can create files, run commands and test the result.

Документація

Work across your apps

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

Документація

Make a workflow you can reuse

Run tasks from scripts or CI with codewhale exec. For larger jobs, save a Fleet of agents with different roles and models and bring the team back when you need it.

Документація

Work across files and tools

Work with your project, connected services, browser tools and agent teams from one session. Choose the model, add the connections you need, and return to the work without starting over.

See all integrations

Файли й термінал: Створюйте файли, запускайте команди, досліджуйте дані й тестуйте результат. Ви задаєте робочу теку та дозволи.
Плагіни й підключені застосунки: Додавайте навички та інструменти через плагіни й MCP. Перевіряйте та вмикайте підключення, якими може користуватися агент.
Браузер і комп’ютер · попередня версія: Працюйте в застосунках і на сайтах із браузерними інструментами та плагіном Computer Use у межах наданого доступу.
Сесії, до яких можна повернутися: Зберігайте разом розмову, результати інструментів та історію. Продовжуйте завдання в терміналі або локальному браузерному клієнті.
Команди агентів: Розподіліть велике завдання через Fleet між агентами з різними ролями й моделями. Стежте за поступом в одному місці.

Set permissions and approvals

Use Plan to explore, Work to carry out a task, and Operate to coordinate larger jobs. Approval settings decide which actions wait for you.

Plan: Blocks file mutation and shell execution. Permitted research may contact external services; session state can still be saved.
Work: Edits files and runs commands within the permission you set.
Operate: Coordinates larger jobs, delegating to other agents when useful. Uses the same tools and permission boundaries as Work.

Ask: Prompts according to the active approval rules; saved permissions and hard policy boundaries still apply.
Auto-Review: Automatically reviews eligible actions and reports any action it cannot approve.
Full Access: Reduces approval prompts. It does not bypass hard policy boundaries or grant access outside the allowed scope.

Available now and in development

The terminal, local browser client, and community CodeWhale GUI are available now and need no Codewhale account. The desktop and hosted web apps are in development and share the same session model; your model connection stays your choice.

Terminal: ReleasedInstall release binaries for Linux, macOS, or Windows; npm and Cargo also work, and Android on Termux is a preview. The interactive TUI and codewhale exec for scripts ship together. Install guide
Local browser: Included with the terminalRun codewhale web to open Codewhale in your browser. Read the conversation, send a task, and answer approvals on your machine. Local browser guide
CodeWhale GUI (VS Code): AvailableA separate community project: chat, threads, and file changes in a VS Code sidebar over the local Runtime. Install it from the VS Code Marketplace; the source is on GitHub. 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.