Ausgabe vom 2026-08-17
v0.9.9
Codewhalejedes Modell, auf deiner Maschine
★ 40.8k
Open Source · Eigenes Modell mitbringen · Läuft im Terminal

Codewhale taucht in die Tiefe,
damit du es nicht musst.

Codewhale ist ein Open-Source-Coding-Agent für dein Terminal. Gib ihm ein Modell und eine Aufgabe — er liest deinen Code, bearbeitet Dateien, prüft selbst und stoppt, wenn die Arbeit erledigt ist oder er dich braucht. Bring jedes Modell mit, oder mische sie: pinne pro Rolle ein eigenes Modell fest.

Installieren Dokumentation GitHub
Installation mit einer Zeile
npm install -g codewhale
braucht Node 18+ — keine Rust-Toolchainweitere Wege →

cwAktuellstes Release v0.9.8Quell-Kandidat v0.9.945 Provider-RoutenMIT

Codewhale TUIAktuelle Sitzung
Aktuelle Codewhale-Terminalsitzung mit Operate-Modus, dem Wal, dem Composer und der Fußzeile
Aktuelle Codewhale-Sitzung · Operate-Modus · Ask-Permission-Posture
EchtzeitLIVE
geöffnet#5485fix(models): bring first-party model rows and pricing current as of 20…von @Hmbownvor 17 mgeöffnet#5484feat(dsh): ambient ocean scene — whales and glyph fish behind the DSH …von @Hmbownvor 26 mgeöffnet#5483web: de-slop the site copy (voice sheet + rewritten surfaces)von @Hmbownvor 28 mgeöffnet#5482EPIC(docs): review, partially restructure, and fully localize document…von @SparkofSpikevor 32 mgeöffnet#5480feat(tui): show and open the live /rc session link; send a stable devi…von @Hmbownvor 38 mgeöffnet#5479Fleet/agents: first-class sub-agent and workflow management in the TUI…von @Hmbownvor 40 mgeöffnet#5478TUI: /rename mid-turn leaves the in-flight shell tool row stuck at "ru…von @Hmbownvor 1 Std.gemerged#5475fix(config): resolve owned direct model casing safelyvon @h3c-hexinvor 1 Std.geöffnet#5477release: 0.9.9 CHANGELOG addendum for #5474/#5475 + contributor credit…von @Hmbownvor 1 Std.gemerged#5474perf(context): compact all noisy web tool resultsvon @h3c-hexinvor 1 Std.geschlossen#5424v0.9.7: Codewhale TUI crashingvon @Hixacvor 1 Std.geöffnet#5473perf(skills): keep configured skill prompts stablevon @h3c-hexinvor 5 Std.veröffentlichtv0.9.8vor 17 Std.geöffnet#4170v0.9.3 architecture D-6: add MCP capability metadatavon @Hmbownletzten Monatgeöffnet#3957v0.9.3 Refactor: split shared modal infrastructure and owned viewsvon @Hmbownvor 2 Monatengeöffnet#2369CodeWhale Config Paths Fragmented Across OS and Cygwin (Plus Silent Mi…von @bukovor 3 Monatengeöffnet#1829SSH 连接失败：exit code 255（疑似 DeepSeek TUI shell 沙箱 TCP 22 出站阻断）von @fodudu1226vor 3 Monatengeöffnet#1651VS Code crashes or exits unexpectedly when YOLO Agent is running test …von @HubgitCCLvor 3 Monatengeöffnet#1425执行大文本处理工程后会话中断卡死von @AiurArtanisvor 3 Monaten

Eine Unterwasser-Terminal-Shell. Jedes Modell. Auf deiner Maschine.

Bring das Modell mit, das du schon nutzt — gehostet, über Gateway oder lokal. Plan / Work / Operate und explizite Permission-Posturen halten den Tauchgang unter deiner Kontrolle.

Sieh, wie es entscheidet

Regeln, die du in der Trace sehen kannst

Echte Sitzungsausschnitte — die gerankte Projekt-Law erscheint im Reasoning des Modells, nicht nur als Behauptung auf einer Landingpage.

codewhale — thinking
Reasoning-Trace
# When the prior session's summary didn't match the repo…
› Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
→ Reported the uncommitted work the summary left out, instead of repeating the claim.
›

Von der Aufgabe zur verifizierten Änderung.

  1. 01

    Inspizieren

    Repository, Anweisungen und Aufgabe lesen.

  2. 02

    Handeln

    Dateien innerhalb expliziter Freigabegrenzen bearbeiten.

  3. 03

    Verifizieren

    Checks ausführen und das Ergebnis prüfen.

  4. 04

    Berichten

    Einen knappen, dauerhaften Laufzeitbeleg hinterlassen.

$ codewhale exec "fix the failing test"inspect   Repository und Anweisungenact       Bearbeiten über die gewählte Permission-Postureverify    cargo test --lockedreport    Checks bestanden · Beleg gespeichert

Neu bei Codewhale? Vier Schritte von Anfang bis Ende.

Installieren → erste schlüssellose Sitzung → Provider verbinden → Fleet einrichten. Begriffe werden auf der Vokabularseite definiert.

  1. Install Codewhale

    One npm command installs the dispatcher and terminal runtime. Cargo, archives, Docker, Nix, and China mirrors are documented alternatives — published releases only.

    npm install -g codewhale
codewhale doctor
    Full install guide →

  2. Open 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.

    codewhale
    Learn the product nouns first →

  3. Connect 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.

    codewhale auth set --provider deepseek
    Providers and models →

  4. Set up your ideal fleet

    Add every provider you use — one auth set per hosted route; keyless local runtimes need nothing — then author the team: /fleet setup walks one role at a time (a model from any configured provider, a thinking tier, permissions) and saves a reusable profile for this repo or every repo on this machine. Fleet state lives in the workspace ledger; ordinary single tasks need none of this.

    /fleet setup
codewhale fleet status
    Fleet and Workflow docs →
Leitfaden für die ersten Schritte lesen →Produktvokabular ansehen →

Dein Modell.
Deine Grenzen.

Wähle Modell, Arbeitsmodus und Permission-Posture explizit. Unbekannte Kosten bleiben als unbekannt deklariert, und Preview-Oberflächen bleiben als solche gekennzeichnet.

45 Provider-Routen
Gehostete, Gateway- und lokale Modelle
Plan · Work · Operate
Von der Nur-Lese-Planung bis zum autonomen Operieren
Ask · Auto-Review · Full Access
Permission-Posture für die Arbeit wählen
TUI · exec · web · API
Interaktive und Headless-Runtime-Oberflächen

Nutze die Runtime dort, wo die Arbeit passiert.

TUIInteraktive Arbeit im Terminal
codewhale execSkripte und CI
Web-ClientBrowser-Client, nur Loopback
Runtime API + MCPLokale Integrationen
FleetDauerhafte Multi-Agenten-Arbeit
Runtime-Oberflächen und Stabilitätshinweise ansehen →

Starte mit einem einzigen Befehl.

npm install -g codewhale

CargoBinärdateienDockerNixWindowsAndroid / TermuxChina-Mirrors

Installationsleitfaden lesen →

Öffentlich gebaut

MIT-lizenziert und geprägt von Beitragenden aus Runtimes, Providern, Plattformen, Dokumentation und Tests.