codewhale-hq/Codewhale

O que é?

Recursos principais

• 01Funciona com mais de 40 provedores de modelos integrados e qualquer endpoint compatível com OpenAI
• 02Oferece suporte a modelos locais por meio do Ollama, vLLM e SGLang
• 03Pede aprovação antes de executar comandos do shell que não sejam somente de leitura, com os níveis de permissão Ask, Auto-Review e Full Access
• 04Registra um comprovante dos arquivos alterados, comandos executados e chamadas externas
• 05Desfaz as alterações em arquivos da última solicitação com /undo
• 06Conecta-se a servidores MCP, skills, plugins e hooks

Casos de uso

• Corrigir testes com falha ou fazer alterações em vários arquivos de um repositório git pelo terminal
• Executar tarefas de programação de forma não interativa em scripts ou CI usando codewhale exec
• Revisar um pull request do GitHub com um comando de revisão consultiva
• Usar um modelo hospedado localmente para manter o código na sua máquina

Início rápido

1. 1

   Instale usando o script oficial de instalação do README

2. 2

   Instale via npm

   npm install -g codewhale
3. 3

   Execute codewhale na raiz de um repositório git

   codewhale
4. 4

   Execute /provider para escolher um provedor e cole a chave de API; em seguida, digite uma tarefa

Antes de usar

• !O Windows ainda não tem sandbox do sistema operacional, e o Full Access desativa o sandbox.
• !A telemetria vem ativada por padrão e pode ser desativada com um comando de configuração.
• !O plugin Computer Use incluído é experimental e está disponível apenas no macOS.
• !Alguns recursos já foram integrados à main, mas ainda não estão disponíveis em uma versão publicada.

Tópicos

Perguntas frequentes

O que é Codewhale?

Agente de programação open source em Rust para o terminal, que edita arquivos, executa comandos e funciona com mais de 40 provedores de modelos, incluindo modelos locais. Codewhale é um agente de programação que roda no terminal. Ao receber uma tarefa, ele lê o repositório, edita arquivos e executa comandos do shell até concluir a tarefa ou precisar da sua ajuda. Ele vem com mais de 40 provedores integrados, incluindo Anthropic, OpenAI, DeepSeek, Google, Mistral e OpenRouter, e também pode usar qualquer endpoint compatível com OpenAI ou modelos locais servidos pelo Ollama, vLLM ou SGLang.

Codewhale é gratuito? Qual é a licença?

Codewhale é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

Codewhale ainda é mantido?

Manutenção ativa. O último commit de Codewhale foi em 19 de out. de 2026.

Para que posso usar Codewhale?

Corrigir testes com falha ou fazer alterações em vários arquivos de um repositório git pelo terminal Executar tarefas de programação de forma não interativa em scripts ou CI usando codewhale exec Revisar um pull request do GitHub com um comando de revisão consultiva Usar um modelo hospedado localmente para manter o código na sua máquina

Como instalar Codewhale?

Instale usando o script oficial de instalação do README Instale via npm: npm install -g codewhale Execute codewhale na raiz de um repositório git: codewhale Execute /provider para escolher um provedor e cole a chave de API; em seguida, digite uma tarefa

Onde consigo Codewhale?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/codewhale-hq/Codewhale