O sintoma é sempre o mesmo: o comando funciona, mas alguma coisa está errada. Uma sessão que não acha arquivo, uma atualização que nunca chega, um aviso de permissão que você ignora há semanas. Antes de reinstalar, existe um comando que despeja o estado da instalação em uma tela só.
Ele se chama /doctor. Roda dentro da sessão do Verboo Code e não altera nada: apenas lê e reporta.
O que o /doctor faz?
Ele verifica como o Verboo Code foi instalado e reporta o que encontrou: tipo de instalação, versão, caminho, binário que o shell invocou, método de configuração, status da busca no diretório, canal de atualização, permissões de escrita no diretório global e dependências do sandbox. Também acumula os avisos de contexto que normalmente passam batido, como CLAUDE.md grande demais, descrições de agentes infladas e servidores MCP que consomem token antes de você digitar qualquer coisa.
É um comando de sessão, implementado como local-jsx. Não existe subcomando de shell equivalente: você abre o verboo e digita dentro dele.
Como rodar o /doctor?
Abra o Verboo Code em qualquer diretório e digite o comando. A leitura acontece na hora e o painel fica na tela até você fechar.
$ verboo
> /doctor
Diagnostics
└ Currently running: npm-global (0.15.43)
└ Path: /usr/local/lib/node_modules/@verboo/code
└ Invoked: /usr/local/bin/node
└ Config install method: npm-global
└ Search: OK (bundled)
Updates
└ Auto-updates: Yes
└ Update permissions: No (requires sudo)
└ Auto-update channel: latest
└ Latest version: 0.15.43
Os valores acima são um exemplo de saída. O que importa é ler os cinco primeiros campos do bloco Diagnostics em ordem, porque eles respondem à pergunta mais comum: quando um problema aparece, é a instalação que você acha que está rodando?
O que cada bloco da saída significa?
| Bloco | O que mostra | Quando importa |
|---|---|---|
| Diagnostics | Tipo de instalação, versão, caminho, binário invocado e método de configuração | Quando o comportamento não bate com a versão que você acha que tem |
| Search | Se a busca de arquivos está funcionando e de onde vem o binário | Quando a sessão não encontra arquivos do projeto |
| Updates | Se a atualização automática está ativa, se há permissão e em qual canal | Quando uma versão nova existe e não chega |
| Sandbox | Se as dependências do sandbox estão presentes | Quando comandos falham de um jeito estranho dentro do sandbox |
| Context Usage Warnings | Arquivos de memória e servidores MCP que consomem contexto | Quando a sessão parece menor do que deveria |
| Invalid Settings | Chaves de configuração que não passaram na validação | Quando uma opção que você definiu simplesmente não tem efeito |
Como resolver os avisos mais comuns?
Cada aviso do painel aponta para um conserto específico, e a maioria é de uma linha.
Warning: Multiple installations found
Existem duas cópias do Verboo Code na máquina e o shell pode estar chamando a que você não atualiza. O próprio bloco lista o tipo e o caminho de cada uma. Compare com o que o shell resolve:
which -a verboo
npm ls -g --depth=0 2>/dev/null | grep -i verboo
A segunda lista mostra a cópia global do npm. Se as duas apontarem para caminhos diferentes, desinstale a que não usa. Manter as duas é a origem mais comum do sintoma "atualizei e nada mudou".
Update permissions: No (requires sudo)
O diretório global é de root e a atualização automática não consegue escrever nele. Ou você instala com um prefixo npm que pertença ao seu usuário, ou atualiza manualmente com sudo. O painel não corrige isso sozinho, só informa.
Search: Not working
A busca de arquivos não está operando. O campo entre parênteses diz de onde o binário deveria vir, bundled quando está embutido no pacote, vendor quando é o da própria distribuição, ou o caminho de um binário de sistema. Quando o modo é de sistema e o caminho não existe mais, o conserto é reinstalar o pacote.
Context Usage Warnings
Três limites aparecem aqui: arquivo de memória grande demais por arquivo, descrições de agentes somando token demais e ferramentas MCP acima do teto de contexto. A lista de maiores contribuintes vem junto, ordenada. Corte o que não usa em vez de aumentar o limite.
Unreachable Permission Rules
Uma regra de permissão sua nunca vai ser avaliada porque outra regra anterior já decide o caso. É o tipo de configuração que parece ativa e não está.
Invalid Settings
Alguma chave do arquivo de configuração não passou na validação. O painel mostra o nome da chave e o motivo, o que evita a caçada em arquivo JSON grande.
O /doctor mostra problema de servidor MCP?
Não, e isso é intencional, mas confunde. O /doctor roda antes de as conexões MCP serem estabelecidas, então a contagem de ferramentas MCP pode vir vazia mesmo com servidores configurados. O aviso de contexto sobre MCP só aparece quando as ferramentas já foram carregadas.
Para diagnostico de servidor MCP, o caminho é o /mcp, que lista cada servidor conectado com status. Use o /doctor para o ambiente e o /mcp para o servidor.
Quando o /doctor não resolve?
Ele descreve estado, não executa reparo. Se o painel está limpo e o problema continua, o próximo passo é olhar a sessão e não a instalação: o modelo respondeu o que se esperava, o arquivo de configuração do projeto foi lido, o diretório de trabalho é o que você pensa. Nesses casos, a resposta costuma estar no histórico da própria sessão, não no diagnóstico da máquina.
O /doctor existe para você não reinstalar por chute. Rode antes de mexer em qualquer coisa, leia o bloco Diagnostics de cima para baixo e conserte o primeiro aviso que aparecer. Se você ainda não usa a Verboo Code, a instalação e o primeiro comando estão em verboo.ai.

![[CC] travado e sem resposta por 15 minutos: como destravar](/_next/image?url=https%3A%2F%2Fstorage.googleapis.com%2Fverboo-landing-page%2Fblog-uploads%2F1783232445352-verboo-code-cover.png&w=3840&q=75)