ReleaseLatest release v0.10.2 · 24 d’oct. del 2026These pages describe v0.10.2, the published release.Changelog →

Primers passos

Instal·la Codewhale, connecta el teu model i dona-li una tasca. Configurar Fleet és opcional.

  1. Install Codewhale

    Install the latest release on macOS or Linux, follow any PATH instruction, and check that the version command prints a version. The guide covers Windows and other install options.

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

    Connect a model API with your provider key. The command below saves a DeepSeek key without echoing it. To run a model yourself, see the provider guide.

    codewhale auth set --provider deepseek
    Connect a provider
  3. Ask about one project file

    Open an existing project folder in your terminal, start Codewhale, choose Plan, and paste the prompt below into the message box. The model receives the file content it needs to answer.

    cd /path/to/your/project
    codewhale
    Read one source file in this project and explain what it does. Cite its file path and the lines that support your explanation. Do not edit files or run commands.
    Set modes and approvals
  4. Check the answer against the file

    Open the cited file yourself and confirm that the cited lines support the explanation to complete this task. Ask about any mismatch, or use the troubleshooting guide if setup fails or no reply arrives.

    Mark this after comparing the answer with the actual file. This records your confirmation rather than judging the model’s work automatically.

    Fix a setup or reply problem

Explore the terminal

Captured views from a local Codewhale demo.

I ara què

Review what changed

Review recorded edits, restore available snapshots and get a code review before pushing.

Set modes and approvals

Compare the published release and source-candidate controls, then choose when Codewhale asks for approval.

Connect your tools

Connect an email tool through MCP, then ask Codewhale to turn the messages it can access into an action list.

Run commands on events

Run your own scripts when a session starts, before a tool call, or when a turn ends. Use them to add context, enforce a rule, or send a notification.