A CLI do seu agente morreu na inicialização.
Aqui está exatamente o porquê.
Uma CLI de agente que não consegue iniciar é a falha mais desmoralizante da codificação com IA: sem saída, sem stack trace, às vezes só o prompt que volta. O CLI Doctor pega esse momento, lê o que realmente aconteceu e responde à única pergunta que importa: o que quebrou e o que eu faço agora.
Ele sabe o comando exato que o AgentsRoom executou, qual flag veio de qual configuração e o que a CLI imprimiu antes de desistir. Esse é o contexto que um resultado de buscador nunca tem.
Uma inicialização que falhou, o erro real e um diagnóstico que aponta a configuração responsável.
As CLIs de agente mudam rápido. Uma flag some em uma release menor, um binário desaparece do seu PATH depois de uma atualização do Node, um login expira, um sandbox se recusa a subir, um arquivo de configuração escrito para outra ferramenta acaba sendo lido. O resultado do seu lado é sempre o mesmo: você envia um prompt e nada acontece.
A parte difícil nunca é a correção. É saber qual das vinte coisas do comando de inicialização é a que quebrou, e se ela veio do app, das suas configurações de provedor, de uma substituição que você definiu naquele agente três semanas atrás, ou da própria CLI que mudou embaixo de você.
O CLI Doctor fecha essa lacuna. Ele guarda um registro do comando exato que foi lançado, marca cada flag com a configuração que a injetou, captura o que a CLI imprimiu e transforma tudo isso em um diagnóstico curto com passos concretos. As verificações determinísticas rodam sempre primeiro e têm prioridade: a IA só fala quando o app não consegue responder sozinho.
O que você recebe no lugar de um terminal em branco
Um resumo em linguagem simples do que falhou, não um stack trace para decifrar. Uma ou duas frases que nomeiam a causa real.
Próximos passos concretos, em ordem. Cada um pode trazer um atalho para o painel de configurações exato, para o comando de reinstalação ou para uma nova inicialização, então você nunca fica caçando onde a opção mora.
Procedência das flags: cada token do comando de inicialização é atribuído à sua origem, então a resposta pode dizer "esta flag vem do modo Autônomo em Configurações" em vez de chutar.
O mesmo tratamento para os comandos de dev. Quando seu comando de build, de teste ou de servidor falha em um terminal, o diagnóstico está a um clique, e de lá você pode passar tudo para um agente DevOps.
Como um diagnóstico acontece
Em camadas, de propósito: as verificações baratas e certas rodam primeiro, a IA é o último recurso.
O AgentsRoom registra a inicialização real
No exato momento em que um terminal é criado, o comando completo é registrado: binário, flags, modelo, opções. É esse registro que torna possível um diagnóstico preciso depois, e ele cobre todos os caminhos pelos quais um agente pode começar, incluindo uma inicialização disparada pelo seu celular ou por um ticket do backlog.
As verificações determinísticas falam primeiro
Um binário ausente, uma flag que a CLI não aceita mais, uma sessão sem login, uma versão desatualizada: são veredictos conhecidos e certos. Eles são respondidos direto com um banner e um botão de correção. Sem chamada de IA, sem espera.
Uma inicialização suspeita é corroborada, não presumida
Se a falha não é um dos casos conhecidos, o AgentsRoom procura um padrão de erro nos primeiros segundos e depois verifica o que está de fato rodando no terminal. Uma CLI que só está lenta para subir, ou ocupada instalando seus servidores MCP na primeira execução, não é uma falha e é descartada.
O contexto higienizado é diagnosticado
Só então a IA entra em cena, com o trecho do erro, o comando sanitizado e o mapa de procedência das flags. System prompts, valores com cara de segredo e argumentos longos entre aspas são higienizados na sua máquina antes de qualquer coisa ser enviada.
Você recebe um resumo e os passos, e decide
O diagnóstico aparece no terminal. Nada é executado no seu lugar: um botão de ação abre as configurações relevantes, oferece uma nova inicialização ou mostra o comando de instalação, e quem aperta continua sendo você.
De onde vem a resposta
O CLI Doctor lê as mesmas superfícies que você configura. Estas são as três que produzem a maior parte das falhas de inicialização.
As flags de inicialização vêm dos padrões do provedor, do modo autônomo, de um modelo fixado ou de uma substituição por agente. É para cá que o diagnóstico costuma mandar você.
Saiba maisComandos de build, de teste e de servidor recebem o mesmo diagnóstico, por clique em vez de automaticamente, porque senão um watch loop que falha pediria diagnóstico para sempre.
Saiba maisSaber que um agente está pensando, concluído, esperando ou morto é o que avisa ao AgentsRoom, antes de tudo, que algo deu errado.
Saiba maisConstruído com os limites óbvios
FAQ
Quais CLIs de agente o CLI Doctor cobre?
Todas. O registro de inicialização é escrito no único ponto em que o AgentsRoom cria um terminal, então Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, OpenCode, Aider, Grok Build, Mistral Vibe e Kimi Code estão todos cobertos, junto com os agentes iniciados pelo companheiro mobile ou por um ticket do backlog.
Ele envia a saída do meu terminal para um servidor?
Ele envia um trecho higienizado do erro de inicialização, o comando de inicialização sanitizado e o mapa de procedência das flags, e só quando um diagnóstico é de fato produzido. System prompts, valores de ambiente com cara de segredo e argumentos longos entre aspas são removidos antes, na sua máquina. Seu código-fonte nunca entra nisso, e o diagnóstico automático pode ser desligado por completo em Configurações, na seção Privacidade e dados.
Ele roda comandos ou muda minhas configurações sozinho?
Não. Um passo pode trazer um atalho que abre o painel de configurações certo, oferece reiniciar o agente ou mostra o comando de instalação para copiar. Executar qualquer coisa é sempre uma ação sua.
O que é procedência de flags, na prática?
O AgentsRoom monta o comando de inicialização a partir de várias camadas: os padrões do provedor, o modo autônomo, o modelo que você escolheu, um esforço de raciocínio, uma substituição de CLI por agente, entre outras. A procedência das flags marca cada token do comando final com a camada que o colocou ali, então o diagnóstico consegue apontar exatamente qual botão virar, em vez de descrever a flag de forma abstrata.
Ele dispara a cada erro?
Não, e isso é proposital. Em um terminal de agente, ele dispara uma vez por episódio de inicialização falha, e só quando a falha é corroborada: uma CLI que está apenas lenta para subir, ou ocupada instalando seus servidores MCP na primeira execução, é descartada em vez de diagnosticada. Nos terminais de comandos de dev, o diagnóstico só acontece por clique, porque um watch loop que falha reemite o erro sem parar.
Está disponível no plano gratuito?
Sim, com uma cota mensal. O Plus aumenta essa cota e o Pro é ilimitado na prática. Os veredictos determinísticos, que cobrem as falhas mais comuns como um binário ausente ou uma flag recusada, não entram na contagem: eles nunca chamam um modelo.
O que acontece com um agente rodando em uma máquina remota via SSH?
Do seu lado, o processo em primeiro plano é o próprio cliente SSH, então uma CLI remota que morre parece saudável daqui e o episódio é ignorado. É um compromisso deliberado: um diagnóstico perdido é preferível a um diagnóstico errado feito com convicção. As verificações determinísticas continuam valendo do lado remoto da conexão.
Qual a diferença em relação a colar o erro em um chatbot?
Um chatbot só enxerga a mensagem que você cola. O CLI Doctor tem também o comando exato que foi executado, a procedência de cada flag dele, o provedor e o modelo em uso e o estado do processo, sem que você monte nada disso. É esse contexto que transforma uma resposta genérica no nome da configuração que precisa mudar.
Você também pode gostar
Multi-Provider
AgentsRoom suporta 9 provedores de codificação IA: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe e Kimi Code. Atribua um provedor diferente por agente, troque de provedor durante a conversa e mantenha todo o contexto com handoff automático. A melhor ferramenta de codificação IA multi-provider.
Rastreamento de status
Acompanhe o status de cada agente Claude Code de relance. Indicadores coloridos para os estados pensando, concluido, inativo e aguardando resposta. Cronometros, resumos de atividade e contadores por projeto.
Terminais dev
Rode seu build, seus testes e seu dev server na mesma janela dos seus agentes, com um sino quando um comando longo termina e um diagnóstico quando ele falha.
Restaurar agentes e terminais
Reabra o app e encontre seus agentes e terminais dev onde você os deixou, com a opção de retomar a conversa anterior da CLI.
Mensagens de Commit de IA
Um gerador de mensagens de commit de IA integrado ao AgentsRoom. Clique na estrela no campo de commit, ele lê o diff real do git e escreve uma mensagem de commit limpa no formato de Conventional Commits. Digite um rascunho, obtenha uma reescrita. As regras de formato da sua equipe são aplicadas em cada geração.
Sugestões de Agentes
Não tem certeza de qual agente de IA usar? Descreva sua tarefa em linguagem simples e o AgentsRoom sugere o agente certo: do seu quarto, os 14 papéis embutidos ou 260+ especialistas do catálogo, com uma razão em uma linha. Um clique atribui a tarefa.
Pare de adivinhar por que seu agente não inicia
O AgentsRoom lê a inicialização, aponta o culpado e entrega a correção. Download gratuito no macOS, Windows e Linux.
App complementar: acompanhe seus agentes em qualquer lugar
Use Claude, Codex, Antigravity CLI ou outro provedor de IA.
Envie bugs e pedidos direto para o seu backlog público.
Uma visão do AgentsRoom em ação.