Open source · Apportez votre modèle · Dans votre terminal

Codewhale plonge dans les profondeurs
pour que vous n’ayez pas à le faire.

Codewhale est un agent de codage open source pour votre terminal. Donnez-lui un modèle et une tâche : il lit votre code, modifie les fichiers, lance ses propres vérifications et s’arrête quand le travail est fini ou quand il a besoin de vous. Apportez n’importe quel modèle, ou mélangez-les : épinglez un modèle différent pour chaque rôle.

installation en une ligne
npm install -g codewhale
nécessite Node 18+ — aucune chaîne d’outils Rustautres méthodes →

cwDernière version v0.9.8Source candidate v0.9.945 routes de fournisseursMIT

Codewhale TUISession en cours
Session Codewhale actuelle dans le terminal : mode Operate, la baleine, le composeur et le pied de page
Session Codewhale actuelle · mode Operate · posture de permissions Ask
En directLIVE
fusionné#5487release: 0.9.9 CHANGELOG addendum — dsh ocean scene, model catalog curpar @Hmbown-4 minfusionné#5485fix(models): bring first-party model rows and pricing current as of 20par @Hmbown-8 minouvert#5486fix(tui): hide the session metrics strip on compact rowspar @Lstarsky0-12 minfusionné#5484feat(dsh): ambient ocean scene — whales and glyph fish behind the DSH par @Hmbown-34 minfusionné#5483web: de-slop the site copy (voice sheet + rewritten surfaces)par @Hmbown-34 minfusionné#5480feat(tui): show and open the live /rc session link; send a stable devipar @Hmbown-53 minfusionné#5477release: 0.9.9 CHANGELOG addendum for #5474/#5475 + contributor creditpar @Hmbown-1 hfusionné#5475fix(config): resolve owned direct model casing safelypar @h3c-hexin-3 hfusionné#5474perf(context): compact all noisy web tool resultspar @h3c-hexin-3 hfusionné#5476release: 0.9.9par @Hmbown-3 hfusionné#5469feat(dsh): apply the Codewhale palette through the bundle profile via par @Hmbown-5 hfusionné#5470fix(tui): DeepSeek V4 tiered peak/off-peak pricing resolved per turnpar @Hmbown-5 hfusionné#5465fix(tui): exec stream creation must fail soft and never wedge the shelpar @Hmbown-5 hfusionné#5471test(pty): deflake release_four_read_only_fleet_roles_launch_with_canopar @Hmbown-6 hfusionné#5466feat(fleet): make agent shadowing visible — roster badge, detail layerpar @Hmbown-6 houvert#5473perf(skills): keep configured skill prompts stablepar @h3c-hexin-6 hfusionné#5464web: advance the published release record to v0.9.8par @Hmbown-6 hpubliév0.9.8-19 h

Un shell sous-marin. N’importe quel modèle. Sur votre machine.

Apportez le modèle que vous utilisez déjà — hébergé, passerelle ou local. Plan / Work / Operate et des postures de permissions explicites gardent la plongée sous votre contrôle.

Voir comment il décide

Des règles visibles dans la trace

Des extraits de sessions réelles : la hiérarchie des règles du projet apparaît dans le raisonnement du modèle, ce n’est pas une simple promesse de page d’accueil.

codewhale — thinking
trace de raisonnement
# 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.

De la tâche au changement vérifié.

  1. 01

    Inspecter

    Lire le dépôt, ses instructions et la tâche.

  2. 02

    Agir

    Modifier les fichiers dans des limites d’approbation explicites.

  3. 03

    Vérifier

    Lancer les vérifications et examiner le résultat.

  4. 04

    Rendre compte

    Laisser un reçu concis et durable.

$ codewhale exec "fix the failing test"inspect   dépôt et instructionsact       modification selon la posture de permissions choisieverify    cargo test --lockedreport    vérifications passées · reçu enregistré

Nouveau sur Codewhale ? Quatre étapes de bout en bout.

Installer → première session sans clé → connecter un fournisseur → configurer votre Fleet. Les termes sont définis sur la page de vocabulaire.

  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

Votre modèle.
Vos limites.

Choisissez explicitement le modèle, le mode de travail et la posture de permissions. Un coût inconnu reste déclaré inconnu, et les surfaces en préversion restent étiquetées comme telles.

45 routes de fournisseurs
Modèles hébergés, passerelle et locaux
Plan · Work · Operate
De la planification en lecture seule à l’opération autonome
Ask · Auto-Review · Full Access
Choisir la posture de permissions pour le travail
TUI · exec · web · API
Surfaces de runtime interactives et sans interface

Utilisez le runtime là où se fait le travail.

TUITravail interactif dans le terminal
codewhale execScripts et CI
Client webClient navigateur en boucle locale uniquement
Runtime API + MCPIntégrations locales
FleetTravail multi-agents durable
Voir les surfaces du runtime et les notes de stabilité →

Commencez avec une seule commande.

npm install -g codewhale

CargoBinairesDockerNixWindowsAndroid / TermuxMiroirs en Chine

Lire le guide d’installation →

Construit en public

Sous licence MIT et façonné par des contributeurs sur les runtimes, les fournisseurs, les plateformes, la documentation et les tests.