Codewhale documentation
ReleaseLatest release v0.10.0 · 22 set 2026These pages describe v0.10.0, the published release.Changelog →

Primi passi

Installa Codewhale, collega il tuo modello e assegnagli un’attività. La configurazione di Fleet è facoltativa.

  1. Install Codewhale

    The command below installs the latest published release on macOS or Linux. Use the install guide for Windows, package managers, or building the unreleased source candidate.

    curl -fsSL https://codewhale.net/install.sh | sh
    Full install guide
  2. Connect your model

    Codewhale needs a model to answer. Save your own provider key, as in the DeepSeek example below, or run a local model such as Ollama, which needs no key. You pay the provider directly.

    codewhale auth set --provider deepseek
    Connect a provider
  3. Give it a task

    Open Codewhale in your project folder and ask for something concrete. Start in /mode plan to have it explain the project without changing anything, then switch to /mode work for edits and commands. It shows each edit as a diff and asks before running a shell command.

    codewhale
    Set modes and approvals
  4. Add a Fleet when you need one

    When a task would benefit from several models and roles, run /fleet setup inside Codewhale to save roles and the model each one uses. From your shell, codewhale fleet status counts the Fleet runs that are queued, running, or finished.

    /fleet setup
    codewhale fleet status
    Run a workflow

E adesso

Review what changed

See every edit in a session, roll files back to an earlier turn, and get a code review before you push.

Set modes and approvals

Plan, Work, or Operate for the kind of work; Ask, Auto-Review, or Full Access for when it stops to ask you.

Run commands on events

Run your own scripts when a session starts, before a tool call, or when a turn ends — to add context, enforce a rule, or get notified.