La CLI del tuo agente è morta all'avvio.
Ecco esattamente perché.
Una CLI di agente che non parte è il fallimento più demoralizzante del coding AI: nessun output, nessuno stack trace, a volte solo un prompt che ritorna. CLI Doctor intercetta quel momento, legge cosa è successo davvero e risponde all'unica domanda che conta: cosa si è rotto, e adesso cosa faccio.
Conosce il comando esatto che AgentsRoom ha eseguito, quale flag arriva da quale impostazione e cosa ha stampato la CLI prima di arrendersi. È il contesto che il risultato di un motore di ricerca non ha mai.
Un avvio fallito, l'errore reale e una diagnosi che indica l'impostazione responsabile.
Le CLI degli agenti si muovono in fretta. Un flag sparisce in una release minore, un binario esce dal tuo PATH dopo un aggiornamento di Node, un login scade, una sandbox si rifiuta di partire, un file di configurazione scritto per un altro strumento viene raccolto. Dalla tua parte il risultato è sempre lo stesso: mandi un prompt e non succede niente.
La parte difficile non è mai la correzione. È capire quale delle venti cose nel comando di avvio è quella che si è rotta, e se arriva dall'app, dalle impostazioni del provider, da un override che hai messo su quel singolo agente tre settimane fa, oppure dalla CLI stessa che è cambiata sotto di te.
CLI Doctor colma questo divario. Tiene traccia del comando esatto che è stato lanciato, marca ogni singolo flag con l'impostazione che lo ha iniettato, cattura cosa ha stampato la CLI e trasforma tutto in una diagnosi breve con passi concreti. I controlli deterministici girano sempre per primi e hanno la precedenza: l'AI parla solo quando l'app non può rispondere da sola.
Cosa ottieni al posto di un terminale muto
Un riepilogo in parole semplici di cosa è fallito, non uno stack trace da decifrare. Una o due frasi che indicano la causa reale.
Passi successivi concreti e in ordine. Ognuno può portare una scorciatoia al pannello di impostazioni esatto, al comando di reinstallazione o a un riavvio, così non devi mai andare a caccia di dove sta l'opzione.
Provenienza dei flag: ogni token del comando di avvio è attribuito alla sua origine, così la risposta può dire "questo flag arriva dalla modalità Autonomous nelle Impostazioni" invece di tirare a indovinare.
Lo stesso trattamento per i comandi di sviluppo. Quando il comando di build, di test o del server fallisce in un terminale, la diagnosi è a un clic di distanza, e da lì puoi passare tutto quanto a un agente DevOps.
Come nasce una diagnosi
A strati, di proposito: i controlli economici e certi girano per primi, l'AI è l'ultima risorsa.
AgentsRoom registra l'avvio reale
Nell'unico momento in cui viene generato un terminale, il comando completo viene registrato: binario, flag, modello, opzioni. È quel record a rendere possibile una diagnosi accurata più tardi, e copre ogni percorso da cui un agente può partire, incluso un avvio lanciato dal telefono o da un ticket del backlog.
I controlli deterministici parlano per primi
Un binario mancante, un flag che la CLI non accetta più, una sessione senza login, una versione obsoleta: sono verdetti noti e certi. Ricevono risposta diretta con un banner e un pulsante di correzione. Nessuna chiamata AI, nessuna attesa.
Un avvio sospetto viene confermato, non dato per scontato
Se il fallimento non rientra nei casi noti, AgentsRoom cerca un pattern di errore nei primi secondi e poi verifica cosa sta davvero girando nel terminale. Una CLI semplicemente lenta a partire, o occupata a installare i suoi server MCP al primo avvio, non è un fallimento e viene scartata.
Il contesto oscurato viene diagnosticato
Solo a quel punto interviene l'AI, con l'estratto dell'errore, il comando ripulito e la mappa di provenienza dei flag. I system prompt, i valori che sembrano segreti e gli argomenti lunghi tra virgolette vengono oscurati sulla tua macchina prima che parta qualsiasi cosa.
Ricevi un riepilogo e dei passi, e decidi tu
La diagnosi compare nel terminale. Niente viene mai eseguito al posto tuo: un pulsante di azione apre le impostazioni pertinenti, propone un riavvio o mostra il comando di installazione, e sei sempre tu a premerlo.
Da dove arriva la risposta
CLI Doctor legge le stesse superfici che configuri tu. Queste sono le tre che producono la maggior parte dei fallimenti di avvio.
I flag di avvio arrivano dai valori predefiniti del provider, dalla modalità autonoma, da un modello fissato o da un override per agente. È qui che la diagnosi ti manda quasi sempre.
Scopri di piùI comandi di build, di test e del server ricevono la stessa diagnosi, su clic invece che in automatico, perché un watch loop che fallisce chiederebbe altrimenti all'infinito.
Scopri di piùSapere che un agente sta pensando, ha finito, sta aspettando o è morto è quello che dice ad AgentsRoom che qualcosa è andato storto.
Scopri di piùCostruito con i limiti che servono
FAQ
Quali CLI di agente copre CLI Doctor?
Tutte. Il record di avvio viene scritto nell'unico punto in cui AgentsRoom genera un terminale, quindi Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, OpenCode, Aider, Grok Build, Mistral Vibe e Kimi Code sono tutte coperte, insieme agli agenti avviati dall'app mobile o da un ticket del backlog.
Invia l'output del mio terminale a un server?
Invia un estratto oscurato dell'errore di avvio, il comando di avvio ripulito e la mappa di provenienza dei flag, e solo quando una diagnosi viene davvero prodotta. I system prompt, i valori d'ambiente che sembrano segreti e gli argomenti lunghi tra virgolette vengono rimossi prima, sulla tua macchina. Il tuo codice sorgente non ne fa mai parte, e la diagnosi automatica si può disattivare del tutto nelle Impostazioni, sotto Privacy e dati.
Esegue comandi o cambia le mie impostazioni da solo?
No. Un passo può portare una scorciatoia che apre il pannello di impostazioni giusto, propone di riavviare l'agente o mostra il comando di installazione da copiare. Eseguire qualcosa è sempre una tua azione.
Cos'è concretamente la provenienza dei flag?
AgentsRoom assembla un comando di avvio a partire da più livelli: i valori predefiniti del provider, la modalità autonoma, il modello che hai scelto, un livello di ragionamento, un override CLI per agente e altro ancora. La provenienza dei flag marca ogni token del comando finale con il livello che ce l'ha messo, così la diagnosi può indicare l'interruttore esatto da cambiare invece di descrivere il flag in astratto.
Scatta a ogni errore?
No, ed è voluto. In un terminale di agente scatta una volta per episodio di avvio fallito, e solo quando il fallimento è confermato: una CLI semplicemente lenta a partire, o occupata a installare i suoi server MCP al primo avvio, viene scartata invece che diagnosticata. Per i terminali dei comandi di sviluppo la diagnosi parte solo su clic, perché un watch loop che fallisce riemette il suo errore in continuazione.
È disponibile nel piano gratuito?
Sì, con un limite mensile. Plus lo alza e Pro è illimitato nella pratica. I verdetti deterministici, che coprono i fallimenti più comuni come un binario mancante o un flag rifiutato, non vengono conteggiati affatto: non chiamano mai un modello.
Cosa succede con un agente in esecuzione su una macchina remota tramite SSH?
Il processo in primo piano dalla tua parte è il client SSH stesso, quindi una CLI remota che muore da qui sembra in salute e l'episodio viene saltato. È un compromesso deliberato: una diagnosi mancata è preferibile a una diagnosi sbagliata data con sicurezza. I controlli deterministici restano validi sul lato remoto della connessione.
In cosa è diverso dall'incollare l'errore in un chatbot?
Un chatbot vede solo il messaggio che gli incolli. CLI Doctor ha anche il comando esatto che è stato eseguito, la provenienza di ogni flag al suo interno, il provider e il modello in uso e lo stato del processo, senza che tu debba mettere insieme niente. È quel contesto a trasformare una risposta generica nel nome dell'impostazione da cambiare.
Potrebbe interessarti anche
Multi-Provider
AgentsRoom supporta 9 provider AI per il coding: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe e Kimi Code. Assegna un provider diverso per agente, cambia provider durante la conversazione e mantieni tutto il contesto con handoff automatico. Il miglior strumento di coding AI multi-provider.
Monitoraggio Stato
Monitora lo stato di ogni agente Claude Code a colpo d'occhio. Indicatori colorati per gli stati pensando, completato, in attesa e necessita-input. Timer trascorsi, riepiloghi attivita e conteggi a livello di progetto.
Dev Terminals
Esegui build, test e dev server nella stessa finestra dei tuoi agenti, con un campanello quando un comando lungo finisce e una diagnosi quando fallisce.
Ripristino di agenti e terminali
Riapri l'app e ritrova agenti e dev terminals dove li avevi lasciati, con l'opzione di riprendere la conversazione CLI precedente.
AI Commit Messages
Un generatore di messaggi di commit AI integrato in AgentsRoom. Clicca sulla scintilla nel campo del commit, legge il vero git diff e scrive un messaggio di commit pulito in formato Conventional Commits. Scrivi una bozza, falla riscrivere. Le regole di formato del tuo team vengono applicate a ogni generazione.
Suggerimenti per gli Agenti
Non sei sicuro di quale agente AI utilizzare? Descrivi il tuo compito in linguaggio semplice e AgentsRoom suggerisce l'agente giusto: dalla tua stanza, i 14 ruoli integrati o 260+ esperti del catalogo, con una motivazione in una riga. Un clic assegna il compito.
Smetti di tirare a indovinare perché il tuo agente non parte
AgentsRoom legge l'avvio, indica il colpevole e ti passa la soluzione. Download gratuito su macOS, Windows e Linux.
App companion: monitora i tuoi agenti in movimento
Usa Claude, Codex, Antigravity CLI o un altro provider IA.
Invia bug e richieste direttamente nel tuo backlog pubblico.
Uno sguardo ad AgentsRoom in azione.