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 Capacités

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.

Documentation

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.

Documentation

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.

Documentation

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

Fichiers et terminal: Créez des fichiers, exécutez des commandes, analysez des données et testez vos réalisations. Vous définissez le dossier de travail et les permissions.
Plugins et applications connectées: Ajoutez des compétences et des outils via les plugins et MCP. Vérifiez et activez les connexions que l’agent peut utiliser.
Navigateur et ordinateur · aperçu: Utilisez les outils de navigation et le plugin Computer Use dans les applications et les sites, avec les accès que vous accordez.
Des sessions à reprendre: Conservez ensemble la conversation, les résultats des outils et l’historique. Reprenez la tâche dans le terminal ou son client de navigateur local.
Équipes d’agents: Répartissez un travail important entre des agents aux rôles et modèles différents avec Fleet, et suivez leur progression au même endroit.

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.