An open-source agent for your computer
Build software and run repeatable workflows with Codewhale in your terminal. Add Computer Use to work in Mac apps.
curl -fsSL https://codewhale.net/install.sh | sh
▎ 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) ┃╭──────────────────────────────────────────────────────────────────────────────────────────────────╮│❯ Type a message… ││ [·] │╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ ● Full Access Shift+Tab to change work (Tab) Work bar (Ctrl+]) ← for agents · ↓ to manage website-demo · website-demo context 7%
The conversation, composer and model status in one view.
ChangelogMIT
Latest releases
Published on GitHub. Updates automatically.
Computer Use plugin
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>
- Works in the background
- On macOS the agent can type, click and scroll in a selected app without moving your pointer or taking focus. Some apps and dialogs need foreground interaction.
- Read app controls
- Accessible controls expose buttons, fields and their values, so a text-only model can operate supported apps. Screenshots remain available when the task needs them.
- Automate a separate browser profile
- Browse, fill forms and capture pages in a separate Chromium profile. Computer Use leaves your personal browser tabs and logins alone; signed-in Chrome uses the separate Chromewhale connector.
Use the models you choose
Use provider API keys, an OpenAI-compatible endpoint or local models.
Contribute to Codewhale
393 contributors. Code, docs, translations and skills all help.
Codewhale × OrcaRouterGet 30% extra DeepSeek V4.1 Flash credit on each OrcaRouter top-up. One claim per developer, open until November 21, 2026.Codewhale earns a referral fee from OrcaRouter.Claim on OrcaRouter