O agente de programação de código aberto para qualquer modelo
Codewhale lê seu projeto, edita arquivos e executa seus testes pelo terminal. Conecte um modelo hospedado ou local e escolha quais ações precisam da sua aprovação.
curl -fsSL https://codewhale.net/install.sh | sh
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▎ 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%
New in v0.10.2
Read the changelog- /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.
Crie e automatize pelo seu terminal
Descreva o que você quer criar ou automatizar. Codewhale pode editar arquivos, executar comandos e verificar o resultado, com acesso controlado por você.
Capacidades- Crie aplicativos e ferramentas
- Crie um aplicativo, adicione uma funcionalidade ou escreva um script. Codewhale pode trabalhar com os arquivos do projeto, executar o código e testar o que cria. Documentação
- Automatize o trabalho repetitivo
- Execute fluxos de trabalho pelo terminal, scripts ou CI. Para tarefas maiores, delegue partes do trabalho a uma Fleet de agentes com modelos diferentes. Documentação
- Conecte as ferramentas que você usa
- Adicione ferramentas por meio de plugins e servidores MCP ou use APIs nos seus próprios scripts. Cada serviço precisa de configuração e autenticação próprias. Documentação
Use os modelos que você escolher
Conecte suas contas de provedores, um endpoint compatível com OpenAI ou modelos locais e hospedados por você. Escolha um modelo para a sessão e para cada agente de uma Fleet.
Ver modelos e provedores- Suas contas de API
- Conecte provedores como DeepSeek, OpenAI, Anthropic ou Google com suas próprias chaves. O modelo padrão, deepseek-flash, agora executa DeepSeek-V4.1-Flash.
- Seu gateway
- Use um endpoint compatível com OpenAI e escolha os modelos que ele oferece.
- Sua inferência
- Execute modelos locais ou auto-hospedados com Ollama, vLLM ou SGLang.
- Seu plano do ChatGPT
- Entre com codewhale auth chatgpt para usar um plano do ChatGPT no lugar de uma chave de API. Experimental.
Trabalhe com arquivos e ferramentas
Explore ferramentas e integrações- Arquivos e terminal
- Crie arquivos, execute comandos, examine dados e teste o que constrói. Você define a pasta de trabalho e as permissões.
- Plugins e aplicativos conectados
- Adicione habilidades e ferramentas por plugins e MCP. Revise e habilite as conexões que deseja que o agente use.
- Navegador e computador · prévia
- Use ferramentas de navegador e o plugin Computer Use em aplicativos e sites, com o acesso que conceder.
- Sessões que você pode retomar
- Mantenha conversa, resultados das ferramentas e histórico juntos. Retome a tarefa no terminal ou no cliente de navegador local.
- Equipes de agentes
- Use Fleet para dividir um trabalho maior entre agentes com funções e modelos diferentes e acompanhar seu progresso em um só lugar.
Comece a usar
Instale Codewhale, conecte um modelo e abra uma pasta de projeto. Você pode adicionar plugins e mais agentes conforme precisar.
Install Codewhale
Install the latest release on macOS or Linux. Follow any PATH instruction the installer prints, then open a folder where you want to work. The guide covers Windows and other install options.
Full install guidecurl -fsSL https://codewhale.net/install.sh | shConnect your model
Use a model API you already have, or connect local or self-hosted inference. The command below saves a DeepSeek key; local Ollama models do not need an API key.
Connect a providercodewhale auth set --provider deepseekDescribe your first task
Start Codewhale and describe the result: a small app, a script that saves you time, or a report from your data. Choose its permissions, review what it does and steer it as you go.
Set modes and approvalscodewhaleUse multiple agents
Split a larger job across agents with different roles and models. Inside Codewhale, save your team with /fleet setup, then check its runs with /fleet status.
Set up a Fleet/fleet setup /fleet status
Disponível agora e em desenvolvimento
O terminal e o cliente de navegador local já estão disponíveis. O aplicativo desktop nativo e o novo aplicativo web hospedado estão em desenvolvimento.
- Terminal e navegador local
- LançadoInstale no Linux, macOS ou Windows e depois execute codewhale, ou codewhale web para o cliente de navegador local. npm e Cargo também funcionam; Android no Termux é uma prévia.
- CodeWhale GUI (VS Code)
- DisponívelUm projeto separado, mantido pela comunidade: chat, threads e alterações de arquivos em uma barra lateral do VS Code sobre o mesmo Codewhale Runtime. Instale pelo VS Code Marketplace.
- Aplicativo web hospedado
- Em desenvolvimentoEstá sendo reconstruído para acompanhar o aplicativo desktop e ainda não está aberto. Para usá-lo no navegador hoje, execute codewhale web na sua máquina.
- Desktop
- Build de desenvolvimentoUm aplicativo nativo com o mesmo mecanismo. Revise e faça commit de alterações, acompanhe o trabalho entre projetos e edite uma mensagem para reenviá-la como uma nova ramificação. Ainda não há download público.
O terminal, o navegador local e a GUI não precisam de uma conta do Codewhale. Se você usar sua própria chave de provedor, esse provedor cobra pelo uso.
Contribua com Codewhale
393 pessoas ajudaram a construir o Codewhale. Relate um bug, melhore a documentação ou contribua com código no GitHub.
Instale no macOS ou Linux
GitHub Releases (Binários) · npm · Cargo · Docker · Windows · Android / Termux · Espelhos da China
Ler o guia de instalaçãocurl -fsSL https://codewhale.net/install.sh | sh