Sobre o projeto

Codewhale é um agente de codificação de código aberto que roda no terminal. Escrito em Rust, ele lê um projeto, edita arquivos, executa comandos e verifica seu próprio trabalho usando um modelo hospedado ou local escolhido pelo usuário. O projeto começou como `deepseek-tui` e mantém compatibilidade de configuração e sessão, mas agora é neutro em relação a provedores e mantido independentemente, sem ligação com nenhum provedor de modelo. A instalação no macOS e Linux é feita por meio de um script de instalação oficial que seleciona a versão mais recente publicada; os usuários do Windows baixam um instalador ou arquivo da GitHub Releases. Um comando de atualizador verifica e aplica novas versões. npm e Cargo são suportados como rotas secundárias de empacotamento, junto com Docker, Nix, Scoop, Android/Termux e um espelho CNB opcional. Completions de shell são geradas por shell. O uso gira em torno de executar `codewhale` dentro de uma pasta de projeto, selecionar um provedor com `/provider` e um modelo com `/model`, depois descrever uma tarefa concreta. Tarefas também podem ser executadas de forma não interativa com `codewhale exec`, o que é adequado para scripts e jobs de CI. O agente pode ler repositórios, editar arquivos, executar comandos, inspecionar resultados e continuar trabalhando em direção a um objetivo. Um modo plano permite exploração sem alterações de arquivo ou execução de shell, enquanto um modo de trabalho permite alterações; atalhos de teclado alternam entre níveis de permissão Ask, Auto-Review e Full Access. Além da interface de terminal, um cliente web local integrado se conecta ao mesmo Codewhale Runtime, e ambientes gráficos web e desktop estão em desenvolvimento. Uma extensão do VS Code mantida pela comunidade se conecta ao Runtime local a partir de uma barra lateral. Um plugin de Uso de Computador, incluído no código-fonte, adiciona ferramentas para observar e interagir com outros aplicativos, sujeito a permissões do sistema operacional e requisitos da plataforma. Funcionalidades notáveis incluem conexão com provedores hospedados ou modelos locais por meio do Ollama, vLLM ou SGLang; inspeção de ações propostas e alterações de arquivo resultantes; configurações de aprovação com limites de política rígidos mesmo sob Full Access; desfazer e restaurar para alterações no workspace; sessões salvas, objetivos duráveis, revisão de fluxo de trabalho antes da execução e coordenação de agentes com modelos e papéis diferentes; e extensão por meio de servidores MCP, habilidades, ganchos e arquivos de papel de agente legíveis. Preços de modelos desconhecidos são relatados como desconhecidos, não como gratuitos. A documentação abrange provedores e modelos locais, equipes de agentes, MCP, ganchos, configuração, cliente web local, ordem de autorização, modos e permissões, instalação e layout do repositório. O projeto é licenciado sob MIT, com notificações de terceiros registradas, e aceita relatos de bugs, ideias de funcionalidades e pull requests.