CLACOROO, la sala regia di Claude Code
Un pannello di controllo desktop che mette un'interfaccia grafica sopra ogni file di configurazione che Claude Code legge. Qui trovi le decisioni tecniche che l'hanno reso possibile, non l'elenco delle funzioni.
CLACOROO è un'applicazione desktop costruita con Electron che gestisce plugin, marketplace, skill, agenti, server MCP, hook, quote e chiavi API di Claude Code attraverso un'interfaccia visuale, senza obbligare a ricordare comandi da terminale. Gira su macOS, Windows e Linux, è distribuita con licenza AGPL v3 ed è sviluppata da MAXYMIZE.
Vai al sito di CLACOROO Galleria completa, documentazione e download per macOS, Windows e Linux.
Il problema che risolve
Claude Code conserva la propria configurazione in una costellazione di file JSON dentro la cartella nascosta dell'utente. Plugin abilitati e disabilitati, marketplace registrati, skill, agenti, server MCP, hook: ogni cosa vive in un file diverso, con una sintassi diversa, e si modifica a colpi di comandi da ricordare a memoria o di editing manuale.
Finché i pezzi sono pochi funziona. Quando l'installazione cresce, capire cosa è attivo, quanto pesa sul contesto disponibile e cosa si è rotto diventa un lavoro archeologico fatto di file aperti uno alla volta.
CLACOROO risolve il problema nel modo meno invasivo possibile: non sostituisce la configurazione, la rende visibile. Ogni schermata corrisponde a file che restano esattamente dove sono e continuano a funzionare anche se l'app viene disinstallata.
Le decisioni tecniche che contano
Sono le scelte che hanno determinato la riuscita del progetto. Le riportiamo perché è il tipo di ragionamento che applichiamo a qualsiasi lavoro su misura, non solo a questo.
Il filesystem resta la fonte di verità
La tentazione, in un'app del genere, è tenere uno stato interno e sincronizzarlo. Abbiamo scelto il contrario: nessun database, nessuna copia. CLACOROO legge i file veri al momento in cui servono e scrive sugli stessi file. La conseguenza è che chi preferisce modificare a mano può continuare a farlo senza che l'app se ne risenta, e che disinstallarla non lascia macerie.
Scrittura conservativa: mai cancellare ciò che non si conosce
Un file di configurazione può contenere chiavi introdotte da versioni più recenti dello strumento, o da altri programmi. Riscriverlo per intero significherebbe distruggerle. Ogni salvataggio modifica soltanto i campi che l'interfaccia gestisce davvero e lascia intatto tutto il resto. È una regola che vale ogni riga di codice in più che costa.
Le credenziali non si toccano, si leggono soltanto
Le credenziali OAuth dell'account sono l'unica cosa che l'app non deve poter rompere. Abbiamo tracciato un confine netto: le sezioni che riguardano account e autenticazione sono in sola lettura, mostrano stato e scadenze ma non hanno alcun percorso di scrittura. Il rischio peggiore di un'app di gestione è invalidare l'accesso allo strumento che dovrebbe gestire.
Un terminale vero, non una finta shell
Il terminale integrato non simula l'output di un comando: apre uno pseudo terminale reale con node-pty e lo rende con xterm. Costa di più in termini di build, perché è un modulo nativo da ricompilare per ogni sistema operativo, ma è l'unico modo perché comandi interattivi, colori e sequenze di controllo si comportino come nel terminale di sistema.
Sapere quanto pesa la configurazione prima di iniziare
La dashboard stima quanto la configurazione attiva occupa della finestra di contesto disponibile: skill indicizzate dal frontmatter, prompt di sistema, agenti, file di memoria, server MCP. È il dato che nessuna interfaccia mostrava e che cambia il modo di lavorare, perché rende visibile un costo che altrimenti si scopre solo quando lo spazio finisce.
Con cosa è costruito
Ogni scelta ha una ragione pratica, non di moda. Un'app che deve leggere il filesystem dell'utente e aprire processi reali non poteva essere una pagina web.
Applicazione
- Electron 36
- Node.js
- JavaScript
- Processo main e renderer separati
Terminale integrato
- node-pty
- xterm.js
- addon fit
- addon web-links
Distribuzione
- electron-builder
- DMG firmato per macOS
- Homebrew Cask
- build Windows e Linux
Qualità
- patch-package
- audit automatico delle traduzioni
- smoke test
- licenza AGPL v3
Cosa significa per il tuo progetto
Se stai valutando chi affidare un lavoro simile, questi sono i problemi che sappiamo già come affrontare.
- Applicazioni desktop che devono integrarsi con strumenti già installati sulla macchina dell'utente, senza chiedergli di cambiare abitudini o di rinunciare a quello che usa oggi.
- Interfacce costruite sopra sistemi esistenti che restano pienamente utilizzabili anche senza l'interfaccia: un requisito che sembra ovvio e che quasi nessun prodotto rispetta davvero.
- Distribuzione multipiattaforma con firma e pacchettizzazione per macOS, Windows e Linux, inclusa la pubblicazione su gestori di pacchetti come Homebrew.
- Strumenti interni per team di sviluppo, dove il risultato si misura in ore risparmiate ogni settimana e non in numero di funzioni.
Domande frequenti
Che cos'è CLACOROO?
CLACOROO è un'app desktop che dà interfaccia grafica alla configurazione di Claude Code: plugin, marketplace, skill, agenti, server MCP, hook, statistiche d'uso e quote. Gira su macOS, Windows e Linux ed è sviluppata da MAXYMIZE. Il nome viene da CLAude COde COntrol ROOm.
CLACOROO è gratuito?
Sì. È distribuito con licenza AGPL v3, quindi è software libero: si può usare, studiare e modificare. Il progetto è sostenuto da donazioni volontarie tramite GitHub Sponsors, Buy Me a Coffee e PayPal.
Modifica i miei file di configurazione in modo distruttivo?
No. Ogni salvataggio tocca soltanto i campi gestiti dall'interfaccia e lascia intatto tutto il resto, comprese le chiavi che l'app non conosce. Le credenziali di autenticazione sono in sola lettura e non vengono mai riscritte. Chi preferisce modificare i file a mano può continuare a farlo.
Potete costruire uno strumento simile per il mio team?
Sì, è esattamente il tipo di lavoro che facciamo. App desktop multipiattaforma, pannelli di controllo interni, interfacce sopra sistemi esistenti. Il punto di partenza è capire quale processo manuale ti costa più tempo ogni settimana. Da lì si definisce l'ambito e si arriva a un preventivo.
Ti serve uno strumento su misura per il tuo team?
Raccontaci quale processo manuale ti sta costando più tempo. Nella prima chiamata capiamo insieme se ha senso costruirlo e cosa comporta.