Saltar al contenido principal

​
Requisitos

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (opcional — solo necesario para compilar desde el código fuente)

​
Instalación

npm install -g failproofai

​
Inicio rápido

1

Activar las políticas

Las políticas son reglas que se ejecutan antes y después de cada llamada a una herramienta del agente. Detectan comandos destructivos, fugas de secretos y otros modos de fallo antes de que causen daño.
failproofai policies --install
Esto escribe entradas de hook en el archivo settings.json de Claude Code. También puedes instalar para un único proyecto o seleccionar políticas específicas:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Verificar

failproofai policies
Muestra todas las políticas, si están activadas y los parámetros configurados.
3

Abrir el panel de control

failproofai
Abre un panel de control local en http://localhost:8020 donde puedes explorar sesiones, inspeccionar llamadas a herramientas y gestionar políticas.
4

Ejecutar tu agente

Inicia Claude Code como de costumbre. Si el agente intenta hacer algo arriesgado, failproofai lo intercepta automáticamente. Déjalo correr sin supervisión y revisa lo ocurrido en el panel de control.

​
Cómo funcionan las políticas

Cada vez que un agente ejecuta una herramienta, Claude Code llama a failproofai como subproceso: 
Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                 evaluates policies
                                                 writes decision to stdout
Cada política devuelve una de tres decisiones:
  • allow — el agente continúa con normalidad
  • deny — la acción es bloqueada y el agente recibe una explicación
  • instruct — se añade contexto adicional al prompt del agente
Las políticas se ejecutan en tu proceso local. No se envía nada a ningún servicio remoto.

​
Almacenamiento de datos

Toda la configuración y los registros permanecen en tu máquina:
RutaContenido
~/.failproofai/policies-config.jsonConfiguración global de políticas
~/.failproofai/hook-activity.jsonlHistorial de ejecución de hooks
~/.failproofai/hook.logRegistro de depuración para errores de hooks personalizados
.failproofai/policies-config.jsonConfiguración por proyecto (incluida en el repositorio)
.failproofai/policies-config.local.jsonAjustes personales (excluidos con gitignore)

​
Desinstalación

failproofai policies --uninstall
Elimina las entradas de hook de ~/.claude/settings.json. Los archivos de configuración en ~/.failproofai/ se conservan.

​
Próximos pasos

Configuración

Ámbitos y formato de los archivos de configuración

Políticas integradas

Las 26 políticas disponibles con sus parámetros

Políticas personalizadas

Escribe tus propias políticas en JavaScript

Monitor de agentes

Supervisa sesiones y revisa la actividad de las políticas