Pular para o conteúdo principal
Execute doctor primeiro sempre que você encontrar comportamento inesperado. Ele expõe rapidamente diretórios ausentes, receitas que não podem ser analisadas, um lockfile obsoleto e ferramentas ausentes antes de você se aprofundar.
O comando doctor inspeciona sua configuração local e reporta o status de cada verificação:

Verificações executadas

Cada verificação reporta ok ou warn. Um resultado warn não impede a ferramenta de rodar, mas pode explicar um comportamento inesperado. process_lock reporta warn quando o lockfile parece obsoleto ou malformado. Isso geralmente significa que uma execução anterior terminou inesperadamente, e a próxima execução pode limpá-lo. O doctor verifica arquivos locais, ferramentas locais e realiza uma requisição leve à API do GitHub para verificar seu limite de taxa e o status do token.
Adicione --json para obter saída legível por máquina adequada para scripts ou monitoramento:

Problemas comuns

Os arquivos de receita falharam ao ser analisados Execute validate para identificar quais arquivos têm erros e qual é o erro de análise:
Para verificar uma única receita por nome:

Diretório de configuração não encontrado Inicialize o diretório de configuração com:
Isso cria a estrutura de diretórios esperada e um config.yml inicial.
Última modificação em 18 de abril de 2026