Signed-off-by: Hunter Bown <hmbown@gmail.com>
4.8 KiB
Codewhale
Codewhale è un agente di programmazione open source per il terminale, sviluppato in Rust e migliorato pubblicamente insieme alle persone che lo utilizzano.
English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Polski · العربية · Català
Installazione
npm install -g codewhale
codewhale
Al primo avvio, Codewhale ti aiuta a collegare un provider oppure a rimanere offline. Supporta inoltre Cargo, Docker, Nix, Scoop, archivi precompilati, Android/Termux e un mirror CNB. Consulta la guida all’installazione.
Utilizzo
Parla con Codewhale come parleresti con un membro del tuo team:
Fix the failing tests and explain what changed.
Oppure esegui un’attività senza aprire la TUI:
codewhale exec "fix the failing tests and explain what changed"
Codewhale può leggere il tuo repository, modificare file, eseguire comandi, controllare i risultati e continuare a lavorare verso un obiettivo. Sei tu a decidere quanto accesso concedergli.
Perché Codewhale
- Usa il modello che preferisci. Collega provider gestiti oppure modelli locali tramite Ollama, vLLM o SGLang. Cambia provider e modello con
/model. - Mantieni il controllo. Plan è in sola lettura. Ask, Auto-Review e Full Access rendono visibile il comportamento delle approvazioni.
/undoannulla l’ultimo turno e/restoreriporta l’area di lavoro a uno snapshot precedente. - Mantieni organizzati i lavori lunghi. Salva le sessioni, imposta un
/goalduraturo, rivedi i workflow prima dell’esecuzione e coordina gli agenti senza trasformare le loro istruzioni interne in parte della tua conversazione. - Estendi l’agente che hai già. Collega server MCP e skill, configura gli hook e conserva i ruoli degli agenti come file leggibili nel progetto o nelle impostazioni personali.
Esegui /help nella TUI per vedere i comandi e le scorciatoie da tastiera.
Sicurezza
Codewhale viene eseguito sul tuo computer con l’accesso che gli concedi. Le modalità di approvazione e le regole del repository limitano ciò che l’agente può fare; il sandboxing facoltativo del sistema operativo aggiunge un confine di esecuzione più solido dove supportato. I prezzi sconosciuti dei modelli restano indicati come sconosciuti anziché essere segnalati come gratuiti.
Leggi l’ordine di autorizzazione per conoscere l’esatta gerarchia delle regole e la configurazione per le impostazioni locali.
Documentazione
- Provider e modelli locali
- Team di agenti
- MCP, hook e configurazione
- Client web locale
- Tutta la documentazione
Unisciti alla comunità
Codewhale migliora quando le persone lo usano, segnalano ciò che non funziona e aiutano a correggerlo. Se manca un provider, un workflow risulta scomodo o l’interfaccia del terminale ti ostacola, apri una issue. Se sai come migliorarlo, apri una pull request. I primi contributi sono benvenuti e chi contribuisce mantiene il riconoscimento per il lavoro integrato.
Unisciti a Discord, oppure aggiungi Hunter su WeChat (hunterbown) e chiedi di entrare nel gruppo Whale Brothers.
Storia del progetto
Codewhale è nato come deepseek-tui e conserva ancora la compatibilità con la sua configurazione e le sue sessioni. Ora è indipendente dai provider, viene mantenuto in modo autonomo e non è affiliato ad alcun provider di modelli.
Grazie a ogni persona che ha contribuito e alle comunità open source che hanno aiutato il progetto a crescere. Consulta il registro dei contributori.
