Build apps and automate workflows

Codewhale works in your terminal and local browser, using the models you choose.

Explore the terminal

Captured views from a local Codewhale demo.

▎ 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%

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

Keep larger tasks moving

Operate: Plan, delegate and verify a larger task. Operate uses the same permissions as Work. /mode operate
Fleet: Give agents different roles and models, then reuse those profiles across tasks. /fleet setup
Workflows: Save steps, parallel work and review gates as a process you can run again. codewhale workflow run <workflow>
Skills and plugins: Save a checklist or report format in a Markdown skill, then share it as a plugin. SKILL.md
Receipts and undo: Preview the next primary request, review recorded actions and restore available file snapshots. /receipts

Set permissions and approvals

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.

Where it runs

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.
Computer Use: Mac betaBackground app control on macOS 13.5 or later. Requires the separate helper and plugin. Set up Computer Use