AJUDA / 01

Solução de problemas

O que conferir primeiro quando um agente não abre, uma etapa não avança, a verificação reprova ou o serviço de terminais está em outra versão.

Atualizado para o PrumoGrid 0.5.11

Como usar esta página

Procure o sintoma na tabela da seção correspondente. A coluna "Confira primeiro" traz a causa mais comum; a última coluna, o que fazer. A busca do portal (no alto da lateral) também encontra os sintomas por palavra.

Agentes e terminais

Sintoma	Confira primeiro	O que fazer
O agente não abre ou aparece como não encontrado	A CLI está instalada e autenticada no lado escolhido (Windows ou WSL)?	Abra um terminal comum do mesmo lado e rode `claude` ou `codex`. No WSL, a instalação e o login são os do Linux. Confira o comando em Ferramentas → Perfis de agente….
A CLI pergunta se você confia na pasta	É a primeira vez dela nessa pasta	Responda no próprio terminal. O PrumoGrid não responde por você.
`tg` não é reconhecido	O terminal foi aberto fora do PrumoGrid	O `tg` só existe nos terminais abertos pelo PrumoGrid.
O terminal abriu na pasta errada	O projeto selecionado ao abrir	Os terminais nascem na pasta do projeto selecionado. Feche e abra com o projeto certo, ou use `cd`. Num terminal fora da pasta, o cartão mostra a linha `pasta`.
Colar um print não funciona	A CLI aceita imagens?	Use `Ctrl`+`Shift`+`V` para colar o caminho do arquivo, ou arraste o arquivo para o terminal. A CLI e o modelo precisam aceitar imagens.
Texto não foi entregue a um terminal	O terminal certo, o prompt, um pedido de permissão aberto	Responda a permissão no terminal e veja o motivo da retenção na etapa. Um agente ocupado pode reter a instrução até ficar livre.

Etapas e fluxos

Sintoma	Confira primeiro	O que fazer
O agente terminou, mas a etapa não fica pronta	Pedido de permissão aberto, critério de verificação, aviso de fim de turno	Leia o cartão da etapa e a Atenção. Se a etapa tem verificação, ela só fica pronta quando o comando passar. Em Ferramentas → Aviso de fim de turno…, veja se o aviso da CLI está pronto.
A próxima etapa não começou	A condição da anterior e a janela	A próxima etapa começa quando a anterior fica pronta, com a janela do PrumoGrid aberta. Com a janela fechada, o avanço espera você reabrir.
A etapa foi salva, mas o início não foi confirmado	A etapa já existe	Retome a etapa existente. Não crie outra para compensar.
Outro projeto está desabilitado na Nova etapa	Quantos projetos estão abertos	Passe o mouse para ler o motivo: Só há um projeto aberto. Cadastre o segundo projeto.
Permitir e Recusar estão desligados no pedido	O pedido não pôde ser lido com segurança da tela (por exemplo, quando o terminal quebra a opção do Codex em duas linhas)	Use Ir ao terminal e responda na própria CLI.
O pedido mostrado mudou	O pedido é lido da tela do terminal	Feche o diálogo e abra Ver pedido de novo antes de responder.
Limite de etapas	O plano aceita até 16 etapas	Arquive as concluídas antigas quando a tela oferecer, ou comece um fluxo novo.

Verificação

Sintoma	Confira primeiro	O que fazer
A verificação reprovou	Comando, pasta, dependências, código esperado e a saída	Abra Ver saída da verificação no resultado. Corrija a causa (código, dependências ou o próprio critério) e use Verificar de novo.
A verificação passa mesmo sem o trabalho feito	O critério testa o que foi pedido?	Escreva um critério que falhe antes do trabalho. Veja Verificação.
A verificação demora e desiste	O tempo limite (de 5 a 900 segundos)	Aumente o tempo ou use um comando mais focado.
Não acho a saída da verificação no terminal do agente	A verificação roda no serviço, fora do terminal	A saída está no resultado da etapa.
No worktree, a verificação falha por falta de dependências	O worktree nasce sem `node_modules`	Instale as dependências no worktree antes, ou deixe isso como primeira instrução.

Serviço, janela e atualização

Sintoma	Confira primeiro	O que fazer
O serviço em execução é de outra versão.	Você instalou uma versão nova com sessões abertas	Use Reiniciar agora quando puder encerrar as sessões, ou Depois para adiar até a próxima abertura. Reabrir só a janela não atualiza o serviço.
O rodapé não diz daemon conectado	O serviço parou ou não respondeu	Leia o aviso na tela. Clique no indicador do rodapé para ver as ações disponíveis.
A faixa Restaurar não apareceu depois de reabrir	Houve reinício real do serviço?	Ela só aparece depois que o serviço reiniciou e há painéis sem sessão viva. Reabrir a janela com o mesmo serviço não mostra a faixa, porque os terminais continuam vivos.
A conversa do agente não voltou após o reinício	O histórico da CLI na mesma conta e no mesmo lado	O PrumoGrid guarda o vínculo com a conversa, não uma cópia dela. Sem o identificador, ele abre o seletor de conversas da CLI.
O Windows avisa que o editor é desconhecido	O instalador ainda não é assinado	Confira o SHA-256 do arquivo com o publicado no site antes de executar.
A opção de sandbox não parece valer	Nesta abertura × Próxima abertura	A escolha vale na próxima abertura do aplicativo. Políticas corporativas ou antivírus podem impedir o sandbox; nesse caso o PrumoGrid abre sem ele e avisa.

Regras, histórico e consumo

Sintoma	Confira primeiro	O que fazer
O agente não segue a regra	Alcance da regra, gravação permitida na pasta, conversa aberta antes da regra	Confira Vale para, abra Ver o que o agente lê e, se a conversa já estava aberta, comece outra. Com gravação desligada no cartão, use Como religar.
A regra não foi gravada	Recibo da gravação	Leia o recibo (Ver gravação). Um erro de escrita não é regra entregue; resolva o motivo e salve de novo.
O consumo mostra sem dado	A CLI informa esse dado?	Sem dado quer dizer desconhecido, e não zero. Nem todas as CLIs informam tokens ou contexto.
O histórico sumiu depois de limpar	Limpar registros anteriores oculta registros antigos daquele projeto	As etapas, as evidências e as sessões continuam. Não há como reexibir o recorte nesta versão.
Não acho as etapas de um terminal que fechei	Sessão encerrada	Em Resultados, use Ver etapas de sessões encerradas.
Não consigo remover um worktree	Alterações não commitadas	O diálogo pede uma confirmação reforçada. Sem ela, nada é descartado. Faça commit ou confirme que quer perder as alterações.

Como relatar um problema

Anote a ação que você fez, o projeto, o tipo de terminal (PowerShell, WSL, Git Bash, CMD), a mensagem exata e o horário. O registro do serviço, terminal-grid-daemon.log, fica em %TEMP% (até três arquivos de 50 MB). Antes de compartilhar capturas ou trechos de terminal, revise para não expor código, caminhos ou dados confidenciais.