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à
Per una nuova installazione su macOS o Linux, usa la versione ufficiale di GitHub:
curl -fsSL https://codewhale.net/install.sh | sh
"$HOME/.local/bin/codewhale"Su Windows, scarica l’installer o l’archivio adatto da GitHub Releases. Per aggiornare un’installazione diretta esistente, esegui codewhale update, oppure codewhale update --check per la sola verifica. L’aggiornamento mostra il percorso dell’eseguibile e conserva le build più recenti. npm e Cargo sono opzioni secondarie; consulta la guida all’installazione per migrare da un gestore di pacchetti e configurare PATH.
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.
Il completamento con Tab si attiva con un solo comando per ogni shell — codewhale completion bash|zsh|fish|powershell|elvish. Consulta il completamento della shell.
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.
Preferisci un'interfaccia grafica? L'estensione CodeWhale for VS Code, mantenuta dalla comunità, porta lo stesso agente nella barra laterale di VS Code — chat, conversazioni a thread, diff in tempo reale e gestione delle attività sulla stessa Runtime API, così le sessioni restano sincronizzate con il terminale. Installala dal VS Code Marketplace; il codice sorgente è su GitHub.
- 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.
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.
- Provider e modelli locali
- Team di agenti
- MCP, hook e configurazione
- Client web locale
- Tutta la documentazione
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.
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.
MIT. Le parti adattate da altri progetti open source sono indicate nelle note sui componenti di terze parti.