Hunter Bown
4.9 KiB
Codewhale
Codewhale és un agent de programació de codi obert per al terminal, desenvolupat amb Rust i millorat públicament amb les persones que l’utilitzen.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية
Instal·lació
npm install -g codewhale
codewhale
En la primera execució, Codewhale t’ajuda a connectar un proveïdor o a continuar sense connexió. També admet Cargo, Docker, Nix, Scoop, arxius precompilats, Android/Termux i un mirall CNB. Consulta la guia d’instal·lació.
Ús
Parla amb Codewhale tal com parlaries amb una persona del teu equip:
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. Tu decideixes quant accés li concedeixes.
Per què Codewhale
- Fes servir el model que vulguis. Connecta proveïdors allotjats o models locals mitjançant Ollama, vLLM o SGLang. Canvia de proveïdor i de model amb
/model. - Mantén el control. Plan és només de lectura. Ask, Auto-Review i Full Access fan visible el comportament de les aprovacions.
/undodesfà l’últim torn i/restoreretorna l’espai de treball a una instantània anterior. - 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.
Seguretat
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.
Documentació
- Proveïdors i models locals
- Equips d’agents
- MCP, hooks i configuració
- Client web local
- Tota la documentació
Uneix-te a la comunitat
Codewhale millora quan les persones l’utilitzen, expliquen què no funciona bé i ajuden a corregir-ho. 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. Si saps com millorar-lo, obre una pull request. 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.
Història del projecte
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.