Pular para o conteúdo principal

​
Requisitos

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (opcional — necessário apenas para compilar a partir do código-fonte)

​
Instalação

npm install -g failproofai

​
Início rápido

1

Ativar políticas

Políticas são regras executadas antes e depois de cada chamada de ferramenta do agente. Elas interceptam comandos destrutivos, vazamento de segredos e outros modos de falha antes que causem danos.
failproofai policies --install
Isso grava entradas de hook no settings.json do Claude Code. Você também pode instalar para um único projeto ou escolher políticas específicas:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Verificar

failproofai policies
Exibe todas as políticas, se estão ativas e quaisquer parâmetros configurados.
3

Abrir o painel

failproofai
Abre um painel local em http://localhost:8020 onde você pode navegar por sessões, inspecionar chamadas de ferramentas e gerenciar políticas.
4

Executar seu agente

Inicie o Claude Code normalmente. Se o agente tentar algo arriscado, o failproofai o intercepta automaticamente. Deixe-o rodando sem supervisão e revise o que aconteceu no painel.

​
Como as políticas funcionam

Toda vez que um agente executa uma ferramenta, o Claude Code chama o failproofai como um subprocesso: 
Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                 evaluates policies
                                                 writes decision to stdout
Cada política retorna uma das três decisões:
  • allow — o agente continua normalmente
  • deny — a ação é bloqueada e o agente recebe uma explicação do motivo
  • instruct — contexto adicional é inserido no prompt do agente
As políticas são executadas no seu processo local. Nenhuma informação é enviada para um serviço remoto.

​
Armazenamento de dados

Todas as configurações e logs ficam na sua máquina:
CaminhoO que armazena
~/.failproofai/policies-config.jsonConfiguração global de políticas
~/.failproofai/hook-activity.jsonlHistórico de execução de hooks
~/.failproofai/hook.logLog de depuração para erros em hooks personalizados
.failproofai/policies-config.jsonConfiguração por projeto (versionada)
.failproofai/policies-config.local.jsonSubstituições pessoais (ignoradas pelo git)

​
Desinstalação

failproofai policies --uninstall
Remove as entradas de hook do ~/.claude/settings.json. Os arquivos de configuração em ~/.failproofai/ são mantidos.

​
Próximos passos

Configuração

Escopos e formato dos arquivos de configuração

Políticas integradas

Todas as 26 políticas com seus parâmetros

Políticas personalizadas

Escreva suas próprias políticas em JavaScript

Monitor de agentes

Monitore sessões e revise a atividade das políticas