Pular para o conteúdo principal
O dashboard do failproofai é uma aplicação web local para monitorar suas sessões de agentes de IA e gerenciar políticas. Veja o que seus agentes fizeram enquanto você estava ausente.

​
Iniciando o dashboard

failproofai
Abre em http://localhost:8020. O dashboard lê diretamente do sistema de arquivos — suas pastas de projeto do Claude Code e os arquivos de configuração do failproofai. Nada é gravado em um serviço remoto.

​
Páginas

​
Projetos

Lista todos os projetos do Claude Code encontrados na sua máquina. Os projetos são descobertos a partir de ~/.claude/projects/ (ou do caminho definido por CLAUDE_PROJECTS_PATH). Cada projeto exibe:
  • Nome do projeto (derivado do caminho da pasta)
  • Número de sessões
  • Data da atividade mais recente da sessão
Clique em um projeto para ver suas sessões.

​
Sessões

Lista todas as sessões dentro de um projeto. Cada sessão exibe:
  • ID da sessão
  • Timestamps de início e fim
  • Número de chamadas de ferramentas
  • Contagem de atividade de hooks (políticas que foram acionadas)
Use o filtro de intervalo de datas e a busca por ID de sessão para refinar a lista. As sessões são paginadas. Clique em uma sessão para abrir o visualizador de sessão.

​
Visualizador de sessão

O visualizador de sessão responde à pergunta central para agentes autônomos: o que o agente fez e ele se manteve no caminho certo? Ele exibe uma linha do tempo de tudo o que aconteceu em uma sessão:
  • Mensagens — Respostas de texto do Claude e prompts do usuário
  • Chamadas de ferramentas — Cada ferramenta que o Claude invocou, com sua entrada e saída
  • Atividade de políticas — Para cada chamada de ferramenta, quais políticas foram acionadas e qual decisão elas retornaram
A barra de estatísticas no topo exibe a duração da sessão, o total de chamadas de ferramentas e um resumo das decisões de hooks (contagens de allow / deny / instruct). Você pode exportar a sessão como um arquivo ZIP ou JSONL usando o botão de download.

​
Políticas

Uma página com duas abas para gerenciar políticas e revisar atividades.
  • Ative ou desative políticas individuais com um único clique (grava em ~/.failproofai/policies-config.json)
  • Expanda uma política para configurar seus parâmetros (para políticas que suportam policyParams)
  • Instale ou remova hooks para um determinado escopo
  • Defina um caminho de arquivo de políticas personalizado

​
Atualização automática

O dashboard possui um botão de alternância de atualização automática na navegação superior. Quando ativado, a página atual é atualizada periodicamente para exibir novas sessões e atividades de políticas à medida que aparecem. Essencial para monitorar sessões de agentes autônomos de longa duração.

​
Desativando páginas

Se você precisar apenas de algumas partes do dashboard, defina FAILPROOFAI_DISABLE_PAGES com uma lista de nomes de páginas separados por vírgula: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Valores válidos: policies, projects.

​
Tema

O dashboard suporta modo claro e escuro. Alterne pelo botão na barra de navegação. A preferência é armazenada no armazenamento local do seu navegador.

​
Configurando o caminho dos projetos

Por padrão, o dashboard lê a partir do diretório de projetos padrão do Claude Code. Substitua-o para configurações personalizadas: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Acessando a partir de um host não-localhost

Ao executar o dashboard em modo dev (npm run dev) e acessá-lo a partir de um hostname diferente de localhost — por exemplo, um domínio personalizado, um IP remoto ou uma URL tunelada — você pode ver um aviso como: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Este é o Next.js bloqueando o acesso cross-origin ao seu websocket de HMR (hot module reload), que é um recurso exclusivo do modo dev. Para permitir seu host, use a flag --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
Para múltiplos hosts ou IPs, passe uma lista separada por vírgulas: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Você também pode definir a variável de ambiente FAILPROOFAI_ALLOWED_DEV_ORIGINS: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Isso se aplica apenas ao modo dev. Ao executar failproofai (modo de produção), não há websocket de HMR nem problema de recurso dev cross-origin.