Come combinare codice, design e testo in un unico spazio di lavoro AI — provando Kun

Un tipico flusso di lavoro con gli assistenti AI appare caotico. Uno sviluppatore copia un pezzo di codice dall'IDE in una finestra del browser con ChatGPT, chiede di correggere la logica, incolla il risultato, esegue i test, vede un errore e corre di nuovo nell'interfaccia web. Se a questo si aggiungono attività di scrittura della documentazione o schizzo di prototipi UI, il passaggio da una scheda all'altra diventa infinito.

Gli sviluppatori del progetto Kun hanno deciso di combinare la scrittura del codice, il testo, il design e l'automazione in un unico ambiente locale. La caratteristica principale dello strumento è un runtime condiviso che può collegare simultaneamente un'interfaccia grafica e un terminale.

Un Runtime per Finestra GUI e Console

Kun è costruito su un processo server kun serve. Si avvia sulla macchina locale e gestisce la sessione, le cronologie delle attività, le connessioni LLM e l'esecuzione dei comandi.

Puoi avviare l'app desktop Electron e aprire simultaneamente un terminale nella cartella del progetto inserendo il comando:

kun

Entrambe le interfacce acquisiscono immediatamente lo stesso contesto di lavoro. Hai bisogno di inviare rapidamente una breve precisazione senza staccare le mani dalla tastiera — scrivi in TUI. Vuoi visualizzare diff dei file, modificare una canvas visiva o analizzare un documento PDF con screenshot — passa alla GUI. Tutte le modifiche, il piano d'azione e la cronologia delle chiamate degli strumenti rimangono sincronizzati.

Cinque Spazi di Lavoro per Attività Diverse

Gli autori non hanno limitato il progetto ai confini del "coding AI" base. Lo spazio di lavoro è diviso in cinque blocchi specializzati.

1. Code. Una modalità completa per lavorare con un repository. L'agente può cercare nei file, effettuare modifiche, eseguire comandi console, lanciare test e produrre diff delle modifiche interne.
2. Write. Un ambiente per preparare documentazione, articoli o report. Supporta il completamento inline del testo, la modifica e può esportare i risultati in Markdown, HTML, PDF, DOCX e PPTX.

3. Design. Una modalità per creare prototipi interattivi HTML/CSS e generare file del design system (DESIGN_SYSTEM.md). Un'interfaccia schizzata può essere immediatamente passata al blocco di codifica.

4. Research. Lavorare con il contesto multimodale. Carichi file PDF, grafici o screenshot e l'agente estrae fatti, raccoglie argomenti e genera note finali.
5. Automate. Un modulo per l'esecuzione di attività in background. Qui configuri schedule, loop ripetitivi, hook e colleghi strumenti esterni tramite MCP (Model Context Protocol).

Come Funziona Agent Graph per Attività Complesse

Per domande brevi o modifiche mirate, Kun ha una modalità Direct — una dialogo rapido senza burocrazia superflua. Ma se un'attività si estende su decine di file e richiede verifica sequenziale, entra in gioco la modalità sperimentale Agent Graph.

In questa modalità, l'agente principale (Lead Agent) costruisce prima un grafo delle dipendenze. Poi suddivide l'attività in piccoli sottocompiti e li delega ad agenti figli isolati. A ogni agente figlio vengono assegnati solo i permessi, gli strumenti e l'accesso ai file necessari per la sua fase.

Il risultato del lavoro viene passato lungo la catena solo dopo che il Lead Agent verifica le modifiche e conferma che i test sono passati. Se si verifica un fallimento in qualsiasi passaggio, il grafo non finge che tutto sia andato liscio. Un'attività può essere messa in pausa, corretta manualmente o un nodo separato può essere inviato per la riesecuzione.

Dati Locali e Libertà di Scelta dei Modelli

Kun è progettato con il principio local-first. L'intero database di sessione, i log, le impostazioni locali e i file di progetto vengono memorizzati esclusivamente sul tuo disco.

Allo stesso tempo, il progetto non ti costringe a usare una rete neurale specifica. Attraverso un menu unificato delle impostazioni, puoi collegare praticamente qualsiasi provider:

• Modelli locali tramite Ollama
• API cloud da OpenAI, Anthropic, Gemini, DeepSeek, Qwen o Kimi
• Qualsiasi servizio di terze parti compatibile con OpenAI Chat Completions o Anthropic Messages

Se scegli un provider cloud, i dati specifici della richiesta e i file allegati verranno inviati ai loro server. Vale la pena tenerlo a mente quando si lavora con codice proprietario aziendale.

Come Distribuire e Provare

Pacchetti precompilati per macOS (Intel e Apple Silicon), Windows e Linux sono disponibili sulla pagina delle release del progetto. Se vuoi eseguire il sistema dal codice sorgente o armeggiare con il codice del backend, avrai bisogno di Node.js versione 22.19 o successiva.

Il processo di avvio dal repository è standard:

git clone https://github.com/KunAgent/Kun.git
cd Kun
npm ci
npm run dev

È fornito un comando speciale per avviare il client terminal separatamente:

npm run dev:tui

Dopo il primo avvio, devi solo configurare almeno una chiave API o un modello locale in Ollama, dopodiché puoi aprire il progetto desiderato.

Vale la Pena Installarlo

Kun sembra un tentativo valido di raccogliere il toolkit sparso di uno sviluppatore in un unico sistema gestibile. L'idea di un runtime fluido per TUI e GUI elimina davvero la necessità di copiare il contesto tra finestre della console e del browser.

Una sfumatura da notare è la licenza PolyForm Noncommercial 1.0.0. Per progetti personali, ricerca e apprendimento, lo strumento è completamente gratuito. Tuttavia, l'uso commerciale o l'integrazione in prodotti a pagamento richiederà un permesso separato dagli autori. Detto ciò, le aziende possono richiedere autorizzazione scritta gratuita per l'uso interno dei dipendenti inviando un'email agli sviluppatori.