hmbown--deepseek-tui/README.pt-BR.md

CodeWhale

Um agente de código para o seu terminal. Funciona com qualquer modelo; modelos abertos em primeiro lugar.

Você informa um provedor, um modelo e uma tarefa. Ele lê código, edita arquivos, executa comandos, verifica os resultados e continua até a tarefa terminar ou até precisar de você. TUI para trabalho interativo, codewhale exec para scripts e CI. Rust, MIT, roda inteiramente na sua máquina.

Começou como deepseek-tui. A comunidade que se formou em volta dele precisava de mais provedores, então hoje DeepSeek, Claude, GPT, Kimi, GLM e mais de 30 outros rodam pelo mesmo runtime e pelas mesmas ferramentas.

English · 简体中文 · 日本語 · Tiếng Việt · 한국어 · Español · codewhale.net · Docs · Changelog

Instalação

npm install -g codewhale

Cargo, Docker, Nix, Scoop, arquivos pré-compilados, Android/Termux e um espelho CNB para quem não consegue acessar o GitHub estão cobertos em docs/INSTALL.md. Vindo do deepseek-tui? Sua configuração e suas sessões são preservadas — veja docs/REBRAND.md.

Uso

codewhale auth set --provider deepseek   # or export ANTHROPIC_API_KEY, etc.
codewhale                                # open the TUI
codewhale exec "fix the failing test"    # headless

Na TUI: /model troca provedor e modelo juntos, /fleet executa uma equipe de workers, /restore desfaz um turno, Tab cicla entre Plan / Act / Operate, Shift+Tab cicla a postura de permissão Ask / Auto-Review / Full Access, e ! executa um comando de shell pelo caminho normal de aprovação.

O que ele faz

• Resolve sua escolha de provedor + modelo em uma rota concreta: endpoint, protocolo de comunicação, limite de contexto, preço. Orçamentos de contexto e a exibição de custo vêm da rota real; um preço desconhecido aparece como desconhecido, não como $0. (docs/PROVIDERS.md)
• Conversa com provedores hospedados de modelos abertos (deepseek, openrouter, moonshot, zai, minimax, nvidia-nim, …), com seu próprio vllm / sglang / ollama sem chave, e com a Anthropic nativamente pela Messages API, com thinking e cache de prompt.
• Executa vários workers de forma durável: o Fleet registra o trabalho em um ledger append-only, então as execuções sobrevivem a reinícios e fleet resume retoma de onde as coisas pararam. O Workflow planeja trabalhos maiores em trilhas retomáveis e verificáveis. (docs/FLEET.md)
• Controla risco em código, não em achismo: três modos (Plan é somente leitura), uma postura de permissão separada, sandbox do sistema operacional (Seatbelt, Landlock + seccomp, bwrap), hooks que podem permitir/negar/perguntar a cada chamada de ferramenta, e snapshots em um git paralelo para que /restore nunca toque no seu histórico real.
• Permite que um repositório declare sua própria lei: os invariantes de .codewhale/constitution.json compilam em bloqueios de escrita que nem o Full Access consegue pular. (docs/CONFIGURATION.md)
• Fala MCP nas duas direções, carrega skills reutilizáveis, expõe APIs de runtime HTTP/SSE e ACP, e dá suporte a uma GUI para VS Code da comunidade.
• A TUI mostra o trabalho como recibos que você pode inspecionar, mantém uma única linha ao vivo em movimento, tem um inspetor de contexto de verdade, 12 temas, modos de movimento reduzido e ASCII seguro, e é distribuída em English, 简体中文, 日本語, Tiếng Việt, Español, Português, 한국어 e 繁體中文 parcial.

Todo o resto — configuração, atalhos de teclado, detalhes do sandbox, arquitetura — está em docs e em codewhale.net.

Contribuindo

Todo feedback é um presente. Issues, PRs, passos de reprodução, logs, pedidos de funcionalidade e primeiras contribuições — tudo isso é trabalho real do projeto aqui. Quando um PR não pode ser mesclado como está, os mantenedores aproveitam o que funciona e o autor continua creditado — no commit, no changelog e em docs/CONTRIBUTORS.md. Se um modelo ou provedor que você usa está faltando, ou se algo quebra na sua máquina, nos contar é a coisa mais útil que você pode fazer.

• Issues abertas — boas primeiras contribuições moram aqui
• CONTRIBUTING.md — setup de desenvolvimento e fluxo de PR
• docs/CONTRIBUTORS.md — todo mundo que ajudou a moldar o projeto
• Me pague um café

Obrigado à DeepSeek pelos modelos e pelo apoio que deram início ao projeto, à DataWhale 🐋 por nos receber na família Whale Brother, e a OpenWarp e Open Design pela colaboração na experiência de agente no terminal.

Licença

MIT. Projeto comunitário independente; sem afiliação com nenhum provedor de modelos.