CLI Doctor

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.

Scarica AgentsRoomGratisScopri come funziona

CLI Doctor

Avvio fallito

$ claude --model opus-5 --mcp-debug

error: unknown option '--mcp-debug'

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.

Opzioni CLI per provider e per agente

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ù

Terminali dei comandi di sviluppo

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ù

Monitoraggio dello stato degli agenti

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

Oscurato prima di partire

I system prompt, i valori d'ambiente che sembrano segreti e gli argomenti lunghi tra virgolette vengono rimossi sulla tua macchina, prima che la richiesta di diagnosi parta.

Niente viene eseguito al posto tuo

La diagnosi può proporre di aprire un pannello di impostazioni, riavviare un agente o mostrare un comando di installazione. Non esegue mai un comando da sola.

Le risposte certe restano certe

Un binario mancante o un flag rifiutato ottiene risposta dal controllo deterministico, non da un modello. L'AI parla solo dove non c'è davvero nulla di certo da dire.

FAQ

Chiedici altro

Quali CLI di agente copre CLI Doctor?

Tutte. Il record di avvio viene scritto nell'unico punto in cui AgentsRoom genera un terminale, quindi tutte le 19 CLI di agenti supportate da AgentsRoom (Claude, Codex, GitHub Copilot CLI, Cursor e altre 15) sono 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. Se arrivi davvero al limite, aggiungere la tua chiave API OpenAI nell'app tiene in funzione le diagnosi sulla tua chiave.

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 19 provider AI per il coding: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin, Cursor, Command Code, Muse Code, Pi, MiniMax Code e ZCode. 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 al lavoro, completato, in attesa e necessita-input. Timer trascorsi, riepiloghi attività 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.