| 1 | <!-- source: README.md sha256:ebf1c69de0dc --> |
| 2 | # Codewhale |
| 3 | |
| 4 | 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. |
| 5 | |
| 6 |  |
| 7 | |
| 8 | *Previsualització del terminal d’una compilació de desenvolupament de la v0.9.12.* |
| 9 | |
| 10 | [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [हिन्दी](README.hi.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) |
| 11 | |
| 12 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 13 | [](https://crates.io/crates/codewhale-cli) |
| 14 | [](https://www.npmjs.com/package/codewhale) |
| 15 | [](https://discord.gg/37gfS3ksug) |
| 16 | |
| 17 | ## Instal·lació |
| 18 | |
| 19 | Per a una instal·lació nova a macOS o Linux, fes servir la versió oficial de GitHub: |
| 20 | |
| 21 | ```bash |
| 22 | curl -fsSL https://codewhale.net/install.sh | sh |
| 23 | "$HOME/.local/bin/codewhale" |
| 24 | ``` |
| 25 | |
| 26 | L’instal·lador selecciona l’última versió publicada. El [registre de canvis](CHANGELOG.md) 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. |
| 27 | |
| 28 | A Windows, descarrega l’instal·lador o l’arxiu corresponent de [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases/latest). 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ó](docs/INSTALL.md) per migrar una instal·lació gestionada per paquets i configurar PATH. |
| 29 | |
| 30 | 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](docs/INSTALL.md). |
| 31 | |
| 32 | L’autocompleció amb Tab s’activa amb una sola ordre per shell — `codewhale completion bash|zsh|fish|powershell|elvish`. Consulta [l’autocompleció del shell](docs/INSTALL.md#8-shell-completions). |
| 33 | |
| 34 | ## Ús |
| 35 | |
| 36 | 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: |
| 37 | |
| 38 | ```text |
| 39 | Fix the failing tests and explain what changed. |
| 40 | ``` |
| 41 | |
| 42 | També pots executar una tasca sense obrir la TUI: |
| 43 | |
| 44 | ```bash |
| 45 | codewhale exec "fix the failing tests and explain what changed" |
| 46 | ``` |
| 47 | |
| 48 | 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](docs/MODES.md) explica què permet cada opció. |
| 49 | |
| 50 | ## Terminal, aplicacions i Computer Use |
| 51 | |
| 52 | El terminal i els clients gràfics es connecten al Runtime de Codewhale, que executa l’agent i les seves eines: |
| 53 | |
| 54 | - **Terminal:** `codewhale` obre la interfície interactiva; `codewhale exec` executa una tasca des d’un script o d’una feina de CI. |
| 55 | - **Navegador local:** `codewhale web` obre el [client web local](docs/WEB.md) inclòs, que fa servir el mateix runtime. |
| 56 | - **Aplicació d'escriptori Codewhale (GPUI):** l'aplicació d'escriptori nativa GPUI és la direcció del client de producte (decisió del 2026-09-14; el mapa de fases és a docs/TRANSITION.md del repositori privat codehwhale-gpui). L'aplicació web allotjada a app.codewhale.net es retira per fases; el lloc de màrqueting, l'inici de sessió, la facturació i les pàgines legals i de descàrrega queden al web permanentment. La seva disponibilitat s'indica a la [pàgina del producte](https://codewhale.net/en/product). |
| 57 | |
| 58 | **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](crates/tui/plugins/computer-use/README.md) inclosa i la [configuració de connectors](docs/PLUGINS.md). |
| 59 | |
| 60 | 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](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode); el codi font és a [GitHub](https://github.com/HengQuWorld/CodeWhale-VSCode). |
| 61 | |
| 62 | ## Per què Codewhale |
| 63 | |
| 64 | - **Tria els teus models.** Connecta proveïdors allotjats o models locals mitjançant Ollama, vLLM o SGLang. Fes servir `/provider` per canviar de proveïdor i `/model` per triar un model. |
| 65 | - **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. `/undo` i `/restore` ajuden a recuperar canvis de l’espai de treball. |
| 66 | - **Mantén organitzades les feines llargues.** Desa sessions, defineix un `/goal` durador, revisa els fluxos de treball abans que s’executin i coordina agents sense convertir les seves instruccions internes en part de la teva conversa. |
| 67 | - **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. |
| 68 | |
| 69 | Executa `/help` a la TUI per veure les ordres i les dreceres de teclat. |
| 70 | |
| 71 | ## Seguretat |
| 72 | |
| 73 | 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. |
| 74 | |
| 75 | Llegeix l’[ordre d’autorització](docs/AUTHORIZATION_ORDER.md) per conèixer la jerarquia exacta de polítiques i la [configuració](docs/CONFIGURATION.md) per als ajustos locals. |
| 76 | |
| 77 | ## Documentació |
| 78 | |
| 79 | - [Proveïdors i models locals](docs/PROVIDERS.md) |
| 80 | - [Equips d’agents](docs/FLEET.md) |
| 81 | - [MCP](docs/MCP.md), [hooks](docs/HOOKS.md) i [configuració](docs/CONFIGURATION.md) |
| 82 | - [Client web local](docs/WEB.md) |
| 83 | - [Tota la documentació](docs) |
| 84 | - [Estructura del repositori i guia de contribució](CONTRIBUTING.md#project-structure) |
| 85 | |
| 86 | ## Uneix-te a la comunitat |
| 87 | |
| 88 | **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](https://github.com/Hmbown/CodeWhale/issues/new/choose) o [envia una pull request](CONTRIBUTING.md) perquè el puguem millorar plegats. Les primeres contribucions són benvingudes i qui hi contribueix conserva el reconeixement per la feina incorporada. |
| 89 | |
| 90 | Uneix-te al [Discord](https://discord.gg/37gfS3ksug), o afegeix Hunter a WeChat (`hunterbown`) i demana entrar al grup Whale Brothers. |
| 91 | |
| 92 | ## Història del projecte |
| 93 | |
| 94 | 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. |
| 95 | |
| 96 | 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](docs/CONTRIBUTORS.md). |
| 97 | |
| 98 | ## Llicència |
| 99 | |
| 100 | [MIT](LICENSE). Les parts adaptades d’altres projectes de codi obert consten als [avisos de tercers](docs/THIRD_PARTY_NOTICES.md). |
| 101 |