CLI Doctor

Je agent-CLI sneuvelde bij het starten.
Dit is precies waarom.

Een agent-CLI die niet wil starten is de meest demoraliserende storing in AI-coderen: geen uitvoer, geen stack trace, soms alleen een prompt die terugkomt. CLI Doctor vangt dat moment op, leest wat er werkelijk gebeurde en beantwoordt de enige vraag die telt: wat ging er stuk, en wat doe ik nu.

Het kent het exacte commando dat AgentsRoom uitvoerde, welke vlag uit welke instelling kwam, en wat de CLI afdrukte voordat hij het opgaf. Dat is de context die een zoekresultaat nooit heeft.

CLI Doctor
Starten mislukt
$ claude --model opus-5 --mcp-debug
error: unknown option '--mcp-debug'

Een mislukte start, de echte fout, en een diagnose die de verantwoordelijke instelling benoemt.

Agent-CLI's veranderen snel. Een vlag verdwijnt in een minor release, een binary verdwijnt uit je PATH na een Node-upgrade, een login verloopt, een sandbox weigert te starten, een configuratiebestand dat voor een andere tool is geschreven wordt opgepikt. Het resultaat is aan jouw kant altijd hetzelfde: je stuurt een prompt en er gebeurt niets.

Het moeilijke is nooit de oplossing. Het is weten welk van de twintig dingen in het startcommando degene is die stukging, en of dat uit de app kwam, uit je providerinstellingen, uit een overschrijving die je drie weken geleden op die ene agent zette, of uit de CLI die zelf onder je handen veranderde.

CLI Doctor dicht dat gat. Het bewaart een verslag van het exacte commando dat werd gestart, labelt elke afzonderlijke vlag met de instelling die hem injecteerde, legt vast wat de CLI afdrukte, en maakt daar een korte diagnose met concrete stappen van. Deterministische controles draaien altijd eerst en houden voorrang: de AI spreekt pas wanneer de app het antwoord niet zelf kan geven.

Wat je krijgt in plaats van een lege terminal

Een samenvatting in gewone taal van wat er misging, geen stack trace om te ontcijferen. Een of twee zinnen die de echte oorzaak benoemen.

Concrete vervolgstappen, op volgorde. Elke stap kan een snelkoppeling meedragen naar precies het juiste instellingenpaneel, het herinstallatiecommando of een herstart, zodat je nooit hoeft te zoeken waar een optie zit.

Herkomst van vlaggen: elk token van het startcommando wordt toegewezen aan zijn oorsprong, zodat het antwoord kan zeggen "deze vlag komt uit de Autonome modus in Instellingen" in plaats van te gokken.

Dezelfde behandeling voor ontwikkelcommando's. Wanneer je build-, test- of servercommando faalt in een terminal, is de diagnose één klik verwijderd, en kun je het geheel van daaruit overdragen aan een DevOps-agent.

Hoe een diagnose tot stand komt

Bewust in lagen: de goedkope, zekere controles draaien eerst, de AI is het laatste redmiddel.

01

AgentsRoom legt de echte start vast

Op het ene moment dat een terminal wordt gestart, wordt het volledige commando vastgelegd: binary, vlaggen, model, opties. Dat verslag maakt later een nauwkeurige diagnose mogelijk, en het dekt elke weg waarlangs een agent kan starten, ook een start die vanaf je telefoon of vanuit een backlogticket is aangezet.

02

Deterministische controles krijgen het eerste woord

Een ontbrekend binary, een vlag die de CLI niet meer accepteert, een sessie die niet is ingelogd, een verouderde versie: dat zijn bekende, zekere verdicten. Ze worden direct beantwoord met een banner en een oplosknop. Geen AI-aanroep, geen wachten.

03

Een verdachte start wordt bevestigd, niet aangenomen

Als de storing geen van de bekende gevallen is, zoekt AgentsRoom in de eerste seconden naar een foutpatroon en controleert daarna wat er werkelijk in de terminal draait. Een CLI die simpelweg traag opstart, of bij de eerste run zijn MCP-servers installeert, is geen storing en wordt genegeerd.

04

De geredigeerde context wordt gediagnosticeerd

Pas dan komt de AI erbij, met het foutfragment, het opgeschoonde commando en de herkomstkaart van de vlaggen. Systeemprompts, waarden die op geheimen lijken en lange aangehaalde argumenten worden op jouw machine geredigeerd voordat er iets wordt verstuurd.

05

Jij krijgt een samenvatting en stappen, en jij beslist

De diagnose verschijnt in de terminal. Er wordt nooit iets voor je uitgevoerd: een actieknop opent de bijbehorende instellingen, biedt een herstart aan of toont het installatiecommando, en jij blijft degene die erop drukt.

Waar het antwoord vandaan komt

CLI Doctor leest dezelfde onderdelen die jij configureert. Dit zijn de drie die de meeste startfouten veroorzaken.

Gebouwd met de voor de hand liggende grenzen

Geredigeerd voordat het vertrekt
Systeemprompts, omgevingswaarden die op geheimen lijken en lange aangehaalde argumenten worden op jouw machine verwijderd, voordat het diagnoseverzoek wordt verstuurd.
Er wordt niets voor je uitgevoerd
De diagnose kan aanbieden om een instellingenpaneel te openen, een agent opnieuw te starten of een installatiecommando te tonen. Het voert nooit uit zichzelf een commando uit.
Zekere antwoorden blijven zeker
Een ontbrekend binary of een geweigerde vlag wordt beantwoord door de deterministische controle, niet door een model. De AI komt alleen aan het woord waar er echt niets zekers te zeggen valt.

FAQ

Welke agent-CLI's dekt CLI Doctor?

Allemaal. Het startverslag wordt geschreven op het enige punt waar AgentsRoom een terminal start, dus Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, OpenCode, Aider, Grok Build, Mistral Vibe en Kimi Code vallen er allemaal onder, net als agents die vanuit de mobiele metgezel of vanuit een backlogticket zijn gestart.

Stuurt het mijn terminaluitvoer naar een server?

Het stuurt een geredigeerd fragment van de startfout, het opgeschoonde startcommando en de herkomstkaart van de vlaggen, en alleen wanneer er daadwerkelijk een diagnose wordt gemaakt. Systeemprompts, omgevingswaarden die op geheimen lijken en lange aangehaalde argumenten worden eerst op jouw machine verwijderd. Je broncode maakt er nooit deel van uit, en de automatische diagnose kun je volledig uitschakelen in Instellingen, onder Privacy en gegevens.

Voert het zelf commando's uit of wijzigt het mijn instellingen?

Nee. Een stap kan een snelkoppeling bevatten die het juiste instellingenpaneel opent, aanbiedt om de agent opnieuw te starten of het installatiecommando toont om te kopiëren. Iets uitvoeren is altijd jouw actie.

Wat is herkomst van vlaggen, concreet?

AgentsRoom stelt een startcommando samen uit meerdere lagen: de standaardinstellingen van de provider, de autonome modus, het model dat je koos, een redeneerinspanning, een CLI-overschrijving per agent, en meer. De herkomst van vlaggen labelt elk token van het uiteindelijke commando met de laag die het daar heeft gezet, zodat de diagnose de exacte schakelaar kan aanwijzen in plaats van de vlag abstract te beschrijven.

Gaat het bij elke fout af?

Nee, en dat is bewust. In een agentterminal gaat het één keer af per mislukte startpoging, en alleen wanneer de storing bevestigd is: een CLI die simpelweg traag opstart, of bij de eerste run zijn MCP-servers installeert, wordt genegeerd in plaats van gediagnosticeerd. In terminals met ontwikkelcommando's gebeurt de diagnose alleen op klik, omdat een falende watch-loop zijn fout onophoudelijk blijft herhalen.

Is het beschikbaar in het gratis abonnement?

Ja, met een maandelijks tegoed. Plus verhoogt dat en Pro is in de praktijk onbeperkt. Deterministische verdicten, die de meest voorkomende storingen dekken zoals een ontbrekend binary of een geweigerde vlag, tellen helemaal niet mee: die roepen nooit een model aan.

Wat gebeurt er met een agent die via SSH op een externe machine draait?

Het voorgrondproces aan jouw kant is de SSH-client zelf, dus een externe CLI die sneuvelt ziet er van hieruit gezond uit en de gebeurtenis wordt overgeslagen. Dat is een bewuste afweging: een gemiste diagnose is te verkiezen boven een stellig verkeerde. De deterministische controles gelden nog wel aan de externe kant van de verbinding.

Wat is het verschil met de fout in een chatbot plakken?

Een chatbot ziet alleen het bericht dat je plakt. CLI Doctor heeft daarnaast het exacte commando dat is uitgevoerd, de herkomst van elke vlag daarin, de provider en het model in gebruik en de staat van het proces, zonder dat je daar iets voor hoeft samen te stellen. Die context maakt van een algemeen antwoord de naam van de instelling die je moet wijzigen.

Je vindt dit misschien ook leuk

Stop met raden waarom je agent niet start

AgentsRoom leest de start, wijst de schuldige aan en geeft je de oplossing. Gratis te downloaden op macOS, Windows en Linux.

GratisDownload AgentsRoom

Companion-app: houd je agents onderweg in de gaten

Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.

Download de extensie
Chrome Web Store

Stuur bugs en verzoeken direct naar je openbare backlog.

Een glimp van AgentsRoom in actie.

Meerdere projecten
Multi-provider
Meerdere agenten
Live status
Bestandsverschil & commit
Mobiele metgezel
Live voorbeeld
Agententeams
Browserautomatisering
Backlog-gedreven ontwikkeling
Promptbibliotheek
Vaardighedenbibliotheek
Bekijk alle functies