Come domare il caos di una dozzina di agenti AI in un solo progetto

Recentemente ho provato a eseguire Claude Code per il refactoring di un modulo e GitHub Copilot CLI per riscrivere i test contemporaneamente. Mi sono perso rapidamente tra le schede del terminale e i branch locali hanno accidentalmente sovrascritto i cambiamenti l'uno dell'altro. Sembra che i creatori del progetto Kandev abbiano affrontato lo stesso problema quando hanno deciso di costruire il proprio strumento per gestire gli sviluppatori AI.

Kandev è una piattaforma aperta con un'interfaccia web e una board Kanban che trasforma il lavoro caotico con coder autonomi in un processo chiaro e controllato.

Qual è l'idea principale

Nell'ultimo anno sono emersi molti strumenti CLI per la programmazione: Claude Code, Codex, Copilot CLI, Gemini, Cursor agent, Devin e un'altra ventina di alternative. Ognuno ha i propri punti di forza, ma quando li esegui direttamente nel terminale del tuo laptop, sorgono complicazioni standard:

1. I cambiamenti sono scomodi da revisionare tramite output della console.
2. Eseguire più agenti in parallelo nella stessa cartella porta a conflitti Git.
3. Il carico su CPU e RAM locale cresce con ogni nuovo processo.

Gli sviluppatori di Kandev propongono un approccio diverso: una persona imposta i task, li distribuisce nelle colonne della board e revisiona i diff finali, mentre tutta la generazione di routine rimane alle reti neurali.

Il progetto non è legato al cloud di nessun vendor specifico ed è distribuito con licenza AGPL-3.0. Non c'è raccolta di telemetria e puoi eseguire il server sul tuo hardware o su una VPS isolata.

Task paralleli senza conflitti nei branch

Per impedire che gli agenti interferiscano tra loro e corrompano la directory di lavoro, Kandev utilizza attivamente i meccanismi Git worktree. Ogni card ottiene il proprio ambiente isolato con il proprio branch. Puoi eseguire tre reti neurali diverse simultaneamente: una correggerà il layout, la seconda riscriverà le query SQL e la terza si occuperà della documentazione.

La schermata del workspace dentro Kandev è organizzata come un IDE familiare. Una finestra contiene:

• chat con l'agente o terminale CLI diretto;
• editor di codice integrato con supporto LSP;
• pannello dell'albero dei file e delle modifiche Git;
• finestra di anteprima del risultato nel browser.

Grazie a questo layout, visualizzi il risultato finito e il diff in un normale editor visivo, invece di cercare di parsare infinite righe di testo nella console.

Costruire catene da provider diversi

Una caratteristica interessante di Kandev è la creazione di pipeline da più reti neurali. Lo strumento supporta l'ACP (Agent Client Protocol) aperto, attraverso il quale si connettono più di venti agenti diversi.

Se lo desideri, puoi impostare l'elaborazione dei task passo dopo passo:

1. Claude Code progetta l'architettura e crea un piano.
2. GitHub Copilot genera il codice basandosi sul piano compilato.
3. Codex controlla le modifiche ricevute per errori e vulnerabilità.

Se lo strumento non supporta ancora ACP direttamente, Kandev lo esegue in modalità TUI direttamente dentro l'emulatore di terminale PTY integrato. Questo significa che puoi aggiungere qualsiasi script console in letteralmente un paio di minuti attraverso le impostazioni del profilo.

Lavorare con più repository e sottotask

Spesso un task influenza simultaneamente sia il backend che il frontend. Kandev può collegare una card a più repository. Il sistema creerà un worktree separato per ogni progetto, genererà i branch e raccoglierà le modifiche raggruppate in un'unica finestra di revisione.

Se un task diventa troppo grande, l'agente può generare sottotask che ereditano il contesto della sessione padre. Questo aiuta quando devi dividere un grande refactoring in diverse pull request indipendenti.

Il progetto ha anche il supporto MCP (Model Context Protocol) integrato. Gli agenti dentro Kandev ottengono accesso a strumenti di utilità: possono creare sottotask, inviare messaggi alle card vicine e leggere la cronologia del dialogo di altri agenti.

Dove eseguire gli agenti stessi

I codebase pesanti richiedono risorse considerevoli. Se esegui tre agenti autonomi su un laptop, le ventole inizieranno immediatamente a ruggire al massimo. Kandev risolve questo con la selezione flessibile del runtime.

Il server invia i task per l'esecuzione a diversi ambienti:

• processo locale sul tuo computer;
• container Docker isolato;
• server remoto tramite SSH;
• emulatori cloud come sprites. dev.

Puoi distribuire Kandev su un server potente in ufficio o a casa e gestire le card e revisionare i diff anche da uno smartphone tramite browser. Per una connessione sicura da una rete esterna, gli autori consigliano di usare Tailscale o qualsiasi VPN familiare.

Struttura tecnica sotto il cofano

L'architettura di Kandev è piuttosto diretta. Il backend è scritto in Go e gestisce l'orchestrazione dei processi, il ciclo di vita dei task e il gateway WebSocket. L'intero database e la cronologia delle sessioni vengono archiviati localmente in SQLite a ~/.kandev.

Il frontend è costruito con React usando Vite e Zustand per la gestione dello stato. Monaco Editor viene usato per il lavoro sul codice, xterm.js per il terminale e la griglia di finestre flessibile è costruita sulla libreria dockview.

Il team sta sviluppando anche un'applicazione desktop su Tauri per chi preferisce una finestra separata invece di una scheda del browser.

Attualmente in fase di sviluppo c'è uno strato di autonomia chiamato Office mode. Questa è una modalità per team di agenti permanenti con i propri ruoli, limiti di budget, memoria e passaggio automatico dei task tra agenti.

Avvio rapido

Puoi installare lo strumento con pochi comandi. Per macOS e Linux è disponibile un pacchetto Homebrew:

brew install kdlbs/kandev/kandev
kandev

Se preferisci Node.js, lanciarlo tramite npx farà tutto in un unico passaggio:

npx kandev@latest

Per gli utenti Windows c'è Scoop:

scoop bucket add kandev https://github.com/kdlbs/scoop-kandev
scoop install kandev
kandev

Dopo l'avvio, il server avvierà l'interfaccia web, preparerà SQLite e ti permetterà di allegare immediatamente repository locali o remoti.

Per chi è utile questo progetto

Kandev difficilmente sarà necessario per chi usa occasionalmente un chatbot per generare un breve script. Ma farà risparmiare molto sforzo se:

• usi attivamente gli agenti CLI nello sviluppo quotidiano;
• vuoi eseguire task in parallelo senza perdere il controllo sui commit;
• preferisci mantenere il codice sorgente e i dati di sessione sui tuoi server;
• cerchi un modo per scaricare la generazione di codice pesante dal tuo laptop su una macchina remota.

Il progetto è ancora giovane, con poco più di 500 stelle su GitHub, ma l'idea di combinare Kanban, Git worktree e diverse reti neurali in un'unica interfaccia sembra già pronta per l'uso.