Codewhale és un agent de codi obert que llegeix el teu projecte, edita fitxers, executa ordres i comprova la seva feina amb un model allotjat o local que tu tries. Comença amb una tasca al terminal. Per a una feina més gran, assigna parts de la feina a agents amb models i rols diferents.
Previsualització del terminal d’una compilació de desenvolupament de la v0.9.12.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية
Per a una instal·lació nova a macOS o Linux, fes servir la versió oficial de GitHub:
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"L’instal·lador selecciona l’última versió publicada. El registre de canvis també descriu la versió candidata, encara no publicada, de la pròxima versió; aquests canvis no s’inclouen en les descàrregues publicades fins que la versió està disponible.
A Windows, descarrega l’instal·lador o l’arxiu corresponent de GitHub Releases. Per actualitzar una instal·lació directa existent, executa codewhale update, o codewhale update --check només per comprovar-la. L’actualitzador mostra el camí de l’executable i conserva les compilacions més noves. npm i Cargo són opcions secundàries; consulta la guia d’instal·lació per migrar una instal·lació gestionada per paquets i configurar PATH.
En la primera execució, Codewhale t’ajuda a connectar un proveïdor o a configurar Codewhale sense connexió. Les respostes requereixen un model allotjat o local connectat. Codewhale també admet npm i Cargo com a opcions secundàries de distribució, a més de Docker, Nix, Scoop, Android/Termux i un mirall CNB opcional. Les instal·lacions existents gestionades per paquets reben instruccions de migració. Consulta l’ajuda d’instal·lació i PATH.
L’autocompleció amb Tab s’activa amb una sola ordre per shell — codewhale completion bash|zsh|fish|powershell|elvish. Consulta l’autocompleció del shell.
Obre un terminal a la carpeta del teu projecte i executa codewhale. Tria el proveïdor amb /provider i el model amb /model. Després, descriu una tasca concreta:
Fix the failing tests and explain what changed.
També pots executar una tasca sense obrir la TUI:
codewhale exec "fix the failing tests and explain what changed"Codewhale pot llegir el teu repositori, editar fitxers, executar ordres, inspeccionar els resultats i continuar treballant cap a un objectiu. Fes servir /mode plan per explorar sense modificar fitxers ni executar ordres del shell, i /mode work quan vulguis que faci canvis. Prem Shift+Tab per triar Ask, Auto-Review o Full Access; la guia de modes i permisos explica què permet cada opció.
El terminal i els clients gràfics es connecten al Runtime de Codewhale, que executa l’agent i les seves eines:
- Terminal:
codewhaleobre la interfície interactiva;codewhale execexecuta una tasca des d’un script o d’una feina de CI. - Navegador local:
codewhale webobre el client web local inclòs, que fa servir el mateix runtime. - Aplicacions web i d’escriptori de Codewhale: entorns de treball gràfics en desenvolupament. La seva disponibilitat s’indica a la pàgina del producte.
Computer Use afegeix eines per observar altres aplicacions i interactuar-hi. El connector està inclòs en el codi font actual. Revisa l’accés que demana i activa’l abans de fer-lo servir; els permisos del sistema operatiu i els requisits de la plataforma continuen sent necessaris. Consulta la guia de Computer Use inclosa i la configuració de connectors.
Per al VS Code, l’extensió CodeWhale mantinguda per la comunitat es connecta al Runtime local des d’una barra lateral. Instal·la-la des del VS Code Marketplace; el codi font és a GitHub.
- Tria els teus models. Connecta proveïdors allotjats o models locals mitjançant Ollama, vLLM o SGLang. Fes servir
/providerper canviar de proveïdor i/modelper triar un model. - Mantén el control. Revisa les accions proposades i els canvis que produeixen als fitxers. La configuració d’aprovacions determina quan cal una revisió; Full Access continua respectant els límits obligatoris de les polítiques.
/undoi/restoreajuden a recuperar canvis de l’espai de treball. - Mantén organitzades les feines llargues. Desa sessions, defineix un
/goaldurador, revisa els fluxos de treball abans que s’executin i coordina agents sense convertir les seves instruccions internes en part de la teva conversa. - Amplia l’agent que ja tens. Connecta servidors MCP i habilitats, configura hooks i conserva els rols d’agent com a fitxers llegibles al projecte o a la configuració personal.
Executa /help a la TUI per veure les ordres i les dreceres de teclat.
Codewhale s’executa a la teva màquina amb l’accés que li concedeixes. Els modes d’aprovació i les regles del repositori limiten què pot fer l’agent; l’aïllament opcional del sistema operatiu afegeix un límit d’execució més sòlid allà on és compatible. Els preus desconeguts dels models continuen indicant-se com a desconeguts en lloc de presentar-se com a gratuïts.
Llegeix l’ordre d’autorització per conèixer la jerarquia exacta de polítiques i la configuració per als ajustos locals.
- Proveïdors i models locals
- Equips d’agents
- MCP, hooks i configuració
- Client web local
- Tota la documentació
- Estructura del repositori i guia de contribució
Els informes d’errors, les idees de funcionalitats i les pull requests són benvinguts, tant si fa mesos que fas servir Codewhale com si el proves per primera vegada. Si falta un proveïdor, un flux de treball és incòmode o la interfície del terminal et dificulta la feina, obre una incidència o envia una pull request perquè el puguem millorar plegats. Les primeres contribucions són benvingudes i qui hi contribueix conserva el reconeixement per la feina incorporada.
Uneix-te al Discord, o afegeix Hunter a WeChat (hunterbown) i demana entrar al grup Whale Brothers.
Codewhale va començar com a deepseek-tui i encara manté la compatibilitat amb la seva configuració i les seves sessions. Ara és neutral pel que fa als proveïdors, es manté de manera independent i no està afiliat a cap proveïdor de models.
Gràcies a totes les persones que hi han contribuït i a les comunitats de codi obert que han ajudat el projecte a créixer. Consulta el registre de col·laboradors.
MIT. Les parts adaptades d’altres projectes de codi obert consten als avisos de tercers.