O Codewhale mergulha fundo
para você não precisar.
O Codewhale é um agente de código open source para o seu terminal. Dê a ele um modelo e uma tarefa — ele lê o seu código, edita arquivos, roda as próprias verificações e para quando o trabalho está pronto ou quando precisa de você. Traga qualquer modelo, ou misture vários: defina um modelo diferente para cada função.
npm install -g codewhale
cwÚltimo lançamento v0.9.5Candidato do código-fonte v0.9.640 rotas de provedoresMIT
Um terminal debaixo d'água. Qualquer modelo. Na sua máquina.
Traga o modelo que você já usa — hospedado, via gateway ou local. Plan / Act / Operate e posturas de permissão explícitas mantêm o mergulho sob o seu controle.
Regras que você acompanha no rastro
Trechos de sessões reais — as regras do projeto, em ordem de prioridade, visíveis no raciocínio do modelo. Não é só promessa de landing page.
Da tarefa à mudança verificada.
- 01
Inspecionar
Lê o repositório, as instruções e a tarefa.
- 02
Agir
Edita arquivos dentro de limites de aprovação explícitos.
- 03
Verificar
Roda as verificações e inspeciona o resultado.
- 04
Relatar
Deixa um recibo conciso e duradouro.
Novo no Codewhale? Quatro passos de ponta a ponta.
Instalação → primeira sessão sem chave → conectar um provedor → primeiro workflow com a Fleet. Os termos estão definidos na página de vocabulário.
Install Codewhale
One npm command installs the dispatcher and terminal runtime. Cargo, archives, Docker, Nix, and China mirrors are documented alternatives — published releases only.
Full install guide →npm install -g codewhale codewhale doctorOpen a first session — no key needed
Launches without any API key: short constitution-first setup, then the full interface. Explore in Plan mode — always read-only. Model replies need a provider; that's the next step.
Learn the product nouns first →codewhaleConnect a provider
Pick a supported route — hosted key, gateway, or keyless local runtime (Ollama, vLLM, SGLang). Provider and model stay explicit; reasoning and routing provenance stay separate, and unavailable values stay unavailable.
Providers and models →codewhale auth set --provider deepseekRun a first Fleet workflow
For durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.
Fleet and Workflow docs →codewhale fleet init codewhale fleet run tasks.json --max-workers 4
Seu modelo.
Seus limites.
Escolha explicitamente o modelo, o modo de trabalho e a postura de permissão. Custo desconhecido continua desconhecido, e recursos em prévia seguem rotulados como tal.
- 40 rotas de provedores
- Modelos hospedados, via gateway e locais
- Plan · Act · Operate
- Do planejamento somente leitura à operação autônoma
- Ask · Auto-Review · Full Access
- Escolha a postura de permissão para o trabalho
- TUI · exec · web · API
- Interfaces de runtime interativas e headless
Use o runtime onde o trabalho acontece.
Comece com um comando.
npm install -g codewhale
CargoBináriosDockerNixWindowsAndroid / TermuxEspelhos da China
Ler o guia de instalação →Construído em público
Licenciado sob MIT e moldado por contribuidores em runtimes, provedores, plataformas, documentação e testes.