Saltar al contenido principal
El dashboard de failproofai es una aplicación web local para supervisar tus sesiones de agentes de IA y gestionar políticas. Descubre lo que hicieron tus agentes mientras no estabas.

​
Iniciar el dashboard

failproofai
Se abre en http://localhost:8020. El dashboard lee directamente del sistema de archivos: tus carpetas de proyectos de Claude Code y los archivos de configuración de failproofai. No se escribe nada en ningún servicio remoto.

​
Páginas

​
Proyectos

Muestra todos los proyectos de Claude Code encontrados en tu máquina. Los proyectos se descubren desde ~/.claude/projects/ (o la ruta definida por CLAUDE_PROJECTS_PATH). Cada proyecto muestra:
  • Nombre del proyecto (derivado de la ruta de la carpeta)
  • Número de sesiones
  • Fecha de la actividad más reciente
Haz clic en un proyecto para ver sus sesiones.

​
Sesiones

Lista todas las sesiones dentro de un proyecto. Cada sesión muestra:
  • ID de sesión
  • Marcas de tiempo de inicio y fin
  • Número de llamadas a herramientas
  • Recuento de actividad de hooks (políticas que se activaron)
Usa el filtro de rango de fechas y la búsqueda por ID de sesión para acotar la lista. Las sesiones están paginadas. Haz clic en una sesión para abrir el visor de sesiones.

​
Visor de sesiones

El visor de sesiones responde la pregunta clave sobre los agentes autónomos: ¿qué hizo el agente y se mantuvo en el camino correcto? Muestra una línea de tiempo de todo lo que ocurrió en una sesión:
  • Mensajes - Las respuestas de texto de Claude y los prompts del usuario
  • Llamadas a herramientas - Cada herramienta que Claude invocó, con su entrada y salida
  • Actividad de políticas - Para cada llamada a herramienta, qué políticas se activaron y qué decisión devolvieron
La barra de estadísticas en la parte superior muestra la duración de la sesión, el total de llamadas a herramientas y un resumen de las decisiones de los hooks (conteos de allow / deny / instruct). Puedes exportar la sesión como archivo ZIP o JSONL usando el botón de descarga.

​
Políticas

Una página con dos pestañas para gestionar políticas y revisar la actividad.
  • Activa o desactiva políticas individuales con un solo clic (escribe en ~/.failproofai/policies-config.json)
  • Expande una política para configurar sus parámetros (para políticas que admiten policyParams)
  • Instala o elimina hooks para un ámbito determinado
  • Establece una ruta de archivo de políticas personalizada

​
Actualización automática

El dashboard tiene un interruptor de actualización automática en la navegación superior. Cuando está activado, la página actual se actualiza periódicamente para mostrar nuevas sesiones y actividad de políticas a medida que aparecen. Es esencial para supervisar sesiones de agentes autónomos de larga duración.

​
Deshabilitar páginas

Si solo necesitas algunas partes del dashboard, establece FAILPROOFAI_DISABLE_PAGES con una lista separada por comas de nombres de páginas: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Valores válidos: policies, projects.

​
Tema

El dashboard admite modo claro y oscuro. Cámbialo mediante el botón en la barra de navegación. La preferencia se guarda en el almacenamiento local de tu navegador.

​
Configurar la ruta de proyectos

De forma predeterminada, el dashboard lee desde el directorio estándar de proyectos de Claude Code. Puedes sobreescribirlo para configuraciones personalizadas: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Acceder desde un host que no sea localhost

Cuando ejecutas el dashboard en modo desarrollo (npm run dev) y accedes a él desde un hostname diferente a localhost —por ejemplo, un dominio personalizado, una IP remota o una URL tunelizada— es posible que veas una advertencia como: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Esto es Next.js bloqueando el acceso de origen cruzado a su websocket HMR (hot module reload), que es una función exclusiva del modo desarrollo. Para permitir tu host, usa el flag --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
Para múltiples hosts o IPs, pasa una lista separada por comas: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
También puedes establecer la variable de entorno FAILPROOFAI_ALLOWED_DEV_ORIGINS en su lugar: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Esto solo aplica al modo desarrollo. Al ejecutar failproofai (modo producción), no hay websocket HMR ni problemas de recursos de desarrollo de origen cruzado.