CLI Doctor

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.

Baixar AgentsRoomGrátisVeja como funciona

CLI Doctor

Falha na inicialização

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

error: unknown option '--mcp-debug'

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.

Opções de CLI por provedor e por agente

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 mais

Terminais de comandos de dev

Comandos 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 mais

Rastreamento de status dos agentes

Saber que um agente está pensando, concluído, esperando ou morto é o que avisa ao AgentsRoom, antes de tudo, que algo deu errado.

Saiba mais

Construído com os limites óbvios

Higienizado antes de sair

System prompts, valores de ambiente com cara de segredo e argumentos longos entre aspas são removidos na sua máquina, antes de a solicitação de diagnóstico ser enviada.

Nada é executado no seu lugar

O diagnóstico pode oferecer abrir um painel de configurações, reiniciar um agente ou mostrar um comando de instalação. Ele nunca executa um comando por conta própria.

As respostas certas continuam certas

Um binário ausente ou uma flag recusada é respondido pela verificação determinística, não por um modelo. A IA só fala onde realmente não há nada de certo a dizer.

FAQ

Faça outra pergunta

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 todos os 19 CLIs de agentes que o AgentsRoom suporta (Claude, Codex, GitHub Copilot CLI, Cursor e mais 15) estão 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. Se chegar mesmo à cota, adicionar sua própria chave de API OpenAI no app mantém os diagnósticos rodando com a sua chave.

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 19 provedores de codificação IA: 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. 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 trabalhando, concluído, inativo e aguardando resposta. Cronômetros, 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.