CodewhaleMIT

Um oceano de dados e código

Mergulhe nas profundezas
para que você não precise.

O Codewhale dá às pessoas comuns a alavancagem dos LLMs para construir coisas. No seu terminal, ele lê o repositório, edita arquivos, executa verificações e deixa um recibo — sem assumir que você já fala a língua do código. Roda na sua máquina.

npm install -g codewhale

Último lançamento v0.9.2 · Fonte atual v0.9.2: 36 rotas de provedores · MIT

Codewhale TUICurrent session
Current Codewhale terminal session showing Operate mode, the whale, composer, and footer
Current Codewhale session · Operate mode · Ask permission posture

Um terminal subaquático. Neutro a modelos. Local primeiro.

Traga o modelo hospedado, de gateway ou local que você já usa. O Codewhale roda na sua máquina e trata o modelo como um componente selecionável — não o produto. Plan / Act / Operate e posturas de permissão explícitas mantêm o mergulho profundo sob seu controle.

Da tarefa à mudança verificada.

  1. 01

    Inspecionar

    Lê o repositório, suas instruções e a tarefa.

  2. 02

    Agir

    Edita arquivos dentro de limites de aprovação explícitos.

  3. 03

    Verificar

    Executa verificações e inspeciona o resultado.

  4. 04

    Relatar

    Deixa um recibo conciso e duradouro.

$ codewhale exec "fix the failing test"inspect   repository and instructionsact       edit through the selected permission postureverify    cargo test --lockedreport    checks passed · receipt saved

New to Codewhale? Four steps end to end.

Install → a first keyless session → provider connection → a first Fleet workflow. The nouns are defined on the vocabulary page.

  1. Install Codewhale

    One npm command installs the dispatcher and the terminal runtime. Cargo, prebuilt archives, Docker, Nix, and China mirrors are documented alternatives; every channel serves published releases only.

    npm install -g codewhale
    codewhale doctor
    Full install guide
  2. Open a first session — no key needed

    The runtime launches without any API key: a short constitution-first setup (language, provider readiness, runtime posture, your constitution), then the full interface. Explore in Plan mode — it is always read-only. Model replies need a provider; that is the next step.

    codewhale
    Learn the product nouns first
  3. Connect a provider

    Pick any supported route — a hosted key, a gateway, or a keyless local runtime such as Ollama, vLLM, or SGLang for fully local inference. Provider and model stay explicit; requested and effective reasoning plus routing source are separate provenance fields, and unavailable values stay unavailable.

    codewhale auth set --provider deepseek
    Providers and models
  4. Run a first Fleet workflow

    When work needs durable workers, ordered phases, or receipts, author a reusable agent-team profile and launch a run. Fleet state lives in the workspace ledger and survives restarts; ordinary single tasks need none of this.

    codewhale fleet init
    codewhale fleet run tasks.json --max-workers 4
    Fleet and Workflow docs

Seu modelo.
Seus limites.

Escolha explicitamente o modelo, o modo de trabalho e a postura de permissão. Custo desconhecido permanece desconhecido, e recursos em prévia ficam rotulados como tal.

36 rotas de provedores
Modelos hospedados, de 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.

TUITrabalho interativo no terminal
codewhale execScripts e CI
Cliente webCliente de navegador apenas loopback
Runtime API + MCPIntegrações locais
FleetTrabalho multiagente duradouro
Ver interfaces de runtime e notas de estabilidade →

Comece com um comando.

npm install -g codewhale

Cargo · Binários · Docker · Nix · Windows · Android / Termux · espelhos da China

Ler o guia de instalação →

Construído em público

Licenciado sob MIT e moldado por contribuidores de runtimes, provedores, plataformas, documentação e testes.