README.it.md

Codewhale

Codewhale è un agente open source che legge il tuo progetto, modifica file, esegue comandi e verifica il proprio lavoro usando un modello ospitato o locale a tua scelta. Parti da un’attività nel terminale. Per un lavoro più grande, assegna parti del lavoro ad agenti con modelli e ruoli diversi.

Anteprima del terminale da una build di sviluppo della v0.9.12.

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Polski · العربية · Català

Installazione

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"

L’installer seleziona l’ultima versione pubblicata. Il registro delle modifiche descrive anche la versione candidata, ancora non pubblicata, della prossima versione; queste modifiche saranno incluse nei download pubblicati solo quando la versione sarà disponibile.

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 configurare Codewhale offline. Le risposte richiedono un modello ospitato o locale collegato. Codewhale supporta anche npm e Cargo come opzioni secondarie di distribuzione, oltre a Docker, Nix, Scoop, Android/Termux e un mirror CNB facoltativo. Le installazioni esistenti gestite da un gestore di pacchetti ricevono istruzioni per la migrazione. Consulta la guida all’installazione e a PATH.

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.

Utilizzo

Apri un terminale nella cartella del tuo progetto ed esegui codewhale. Scegli il provider con /provider e il modello con /model. Poi descrivi un’attività concreta:

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. Usa /mode plan per esplorare senza modificare file né eseguire comandi shell, e /mode work quando vuoi che apporti modifiche. Premi Shift+Tab per scegliere Ask, Auto-Review o Full Access; la guida a modalità e permessi spiega cosa consente ogni opzione.

Terminale, app e Computer Use

Il terminale e i client grafici si collegano al Runtime di Codewhale, che esegue l’agente e i suoi strumenti:

• Terminale: codewhale apre l’interfaccia interattiva; codewhale exec esegue un’attività da uno script o da un job di CI.
• Browser locale: codewhale web apre il client web locale incluso, che usa lo stesso runtime.
• App web e desktop di Codewhale: ambienti di lavoro grafici in fase di sviluppo. La loro disponibilità è indicata nella pagina del prodotto.

Computer Use aggiunge strumenti per osservare altre applicazioni e interagire con esse. Il plugin è incluso nel codice sorgente attuale. Controlla l’accesso richiesto e abilitalo prima dell’uso; i permessi del sistema operativo e i requisiti della piattaforma continuano ad applicarsi. Consulta la guida a Computer Use inclusa e la configurazione dei plugin.

Per VS Code, l’estensione CodeWhale mantenuta dalla comunità si collega al Runtime locale da una barra laterale. Installala dal VS Code Marketplace; il codice sorgente è su GitHub.

Perché Codewhale

• Scegli i tuoi modelli. Collega provider gestiti oppure modelli locali tramite Ollama, vLLM o SGLang. Usa /provider per cambiare provider e /model per scegliere un modello.
• Mantieni il controllo. Controlla le azioni proposte e le modifiche ai file che ne derivano. Le impostazioni di approvazione determinano quando è necessaria una revisione; Full Access continua a rispettare i limiti vincolanti delle regole. /undo e /restore aiutano a recuperare le modifiche dell’area di lavoro.
• Mantieni organizzati i lavori lunghi. Salva le sessioni, imposta un /goal duraturo, 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
• Struttura del repository e guida ai contributi

Unisciti alla comunità

Segnalazioni di bug, idee per nuove funzionalità e pull request sono benvenute, sia che usi Codewhale da mesi sia che lo provi per la prima volta. Se manca un provider, un workflow risulta scomodo o l’interfaccia del terminale ti ostacola, apri una issue oppure invia una pull request per migliorarlo insieme. 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.

Licenza

MIT. Le parti adattate da altri progetti open source sono indicate nelle note sui componenti di terze parti.