Voltar para o Blog
Artigoverboo codetutorialtroubleshootingdev tools

/doctor no Verboo Code: como ler o diagnóstico da instalação

Mafra19 de novembro de 20265 min de leitura

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?

BlocoO que mostraQuando importa
DiagnosticsTipo de instalação, versão, caminho, binário invocado e método de configuraçãoQuando o comportamento não bate com a versão que você acha que tem
SearchSe a busca de arquivos está funcionando e de onde vem o binárioQuando a sessão não encontra arquivos do projeto
UpdatesSe a atualização automática está ativa, se há permissão e em qual canalQuando uma versão nova existe e não chega
SandboxSe as dependências do sandbox estão presentesQuando comandos falham de um jeito estranho dentro do sandbox
Context Usage WarningsArquivos de memória e servidores MCP que consomem contextoQuando a sessão parece menor do que deveria
Invalid SettingsChaves de configuração que não passaram na validaçãoQuando 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.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados