Failproof AI CLI

Instala el CLI local con npm install -g failproofai. Ejecútalo sin argumentos para abrir el panel de políticas local. El paquete requiere Node.js 20.9 o superior. Bun 1.3 o superior es compatible para desarrollo e instalaciones desde código fuente. failproofai configure y failproofai setup son alias de failproofai config; failproofai p es un alias de failproofai policies.

Configurar una máquina

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

Ejecuta failproofai sin argumentos para abrir el panel de políticas local.

Comando	Resultado
`failproofai config`	Ejecutar la configuración interactiva de la máquina
`failproofai config --connect <url> --token <key>`	Conectar la ingesta Cloud y la entrega de políticas
`failproofai config --status`	Mostrar el estado de la conexión, el daemon, la entrega y la pausa
`failproofai policies`	Listar políticas integradas, personalizadas, de convención, de paquete y gestionadas por Cloud
`failproofai policies --install`	Instalar hooks y habilitar políticas
`failproofai policy add <name>`	Habilitar una política: una integrada o `<pack-id>:<name>` de un paquete instalado
`failproofai policy remove <name>`	Deshabilitar una política, con la misma nomenclatura
`failproofai policies --uninstall`	Deshabilitar políticas o eliminar los hooks del harness
`failproofai pack list`	Listar los paquetes de políticas instalados y todas las políticas que contienen
`failproofai pack add <source>`	Instalar un paquete de políticas desde una release de GitHub; sin etiqueta toma la más reciente y la fija
`failproofai pack add --bundled`	Instalar las políticas integradas como paquete, desde este package, sin red
`failproofai pack build <entry.mjs>`	Construir los tres activos de release para un paquete propio
`failproofai pack remove <publisher/name>`	Desactivar un paquete instalado
`failproofai audit`	Analizar el historial local del agente y abrir la vista de auditoría local
`failproofai audit --schedule [days] --email <address>`	Programar análisis locales periódicos y enviar sus resultados por correo
`failproofai audit --status`	Mostrar la dirección del informe, el intervalo y el próximo análisis programado
`failproofai audit --no-schedule`	Detener los análisis periódicos sin eliminar el historial de auditoría
`failproofai harness list`	Listar rutas de captura adicionales
`failproofai flush --wait`	Entregar el spool de eventos actual
`failproofai backfill --since 30d`	Releer el historial previamente procesado
`failproofai config --pause [duration]`	Pausar una sesión local durante 30 minutos por defecto, hasta 8 horas
`failproofai config --resume`	Reanudar una sesión local pausada; añade `--all` para eliminar todas las pausas
`failproofai update`	Completar las migraciones del paquete y actualizar el daemon
`failproofai migrate --dry-run`	Previsualizar o ejecutar migraciones pendientes del layout del home
`failproofai uninstall`	Eliminar los hooks y el daemon antes de desinstalar el paquete
`failproofai --version`	Mostrar la versión del paquete instalado
`failproofai --help`	Mostrar los comandos y el uso global

Opciones de configuración

Opción	Uso
`--connect <url> --token <key>`	Conectar de forma no interactiva
`--machine-id <id>`	Establecer el ID estable de la máquina
`--machine-label <name>`	Establecer o cambiar la etiqueta del panel
`--no-transcripts`	Enviar decisiones sin el contenido de la transcripción
`--disconnect`	Detener las extracciones de políticas Cloud y la entrega de eventos
`--status`	Mostrar el estado actual de la máquina
`--pause [duration]`	Pausar la sesión más reciente en el directorio actual; acepta segundos, minutos u horas y por defecto son 30 minutos
`--resume`	Terminar una pausa coincidente antes de tiempo
`--session <id>`	Apuntar a una sesión específica para pausar o reanudar
`--all`	Con `--resume`, terminar todas las pausas activas

Las pausas locales suspenden las políticas integradas, personalizadas, de convención y de paquete para una sesión. Siempre expiran y no deshabilitan las políticas gestionadas por Cloud. block-failproofai-commands — que siempre está activo y no puede deshabilitarse ni pausarse — impide que un agente instrumentado utilice esta vía de escape por sí mismo.

Opciones de políticas

Opción	Uso
`--install`, `-i`	Habilitar políticas e instalar los hooks del harness
`--uninstall`, `-u`	Deshabilitar políticas o eliminar hooks
`--cli <names...>`	Apuntar a uno o más harnesses compatibles
`--scope user\|project\|local\|all`	Elegir el ámbito de configuración; `all` es para desinstalar
`--beta`	Incluir políticas beta
`--custom`, `-c <path>`	Validar y cargar un archivo de política personalizado; repetible

Opciones de entrega y mantenimiento

Comando	Opciones
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update debe ejecutarse después de npm install -g failproofai@latest; realiza las migraciones del layout del home, instala el binario del daemon correspondiente y reinicia el servicio. --no-daemon realiza únicamente la migración del layout.

Rutas del harness

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

Los nombres de harness compatibles son claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity y goose. Las etiquetas dan espacio de nombres a los IDs de agente derivados cuando dos raíces contienen copias del mismo proyecto. Las raíces superpuestas y las etiquetas duplicadas se rechazan para evitar colecciones duplicadas o corrupción del cursor. La configuración de rutas adicionales se recarga sin necesidad de reiniciar el daemon. Los entornos de contenedor pueden reemplazar las rutas adicionales configuradas en archivos con una variable separada por comas llamada FAILPROOFAI_<HARNESS>_EXTRA_PATHS, por ejemplo:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

Variables de entorno

Usa archivos de configuración para el comportamiento persistente de la máquina. Las variables de entorno son más útiles para contenedores, pruebas y procesos individuales.

Variable	Uso
`FAILPROOFAI_HOME`	Reubicar el layout completo de `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	Establecer la verbosidad del registro local
`FAILPROOFAI_HOOK_LOG_FILE`	Escribir diagnósticos de hooks en un archivo seleccionado
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Deshabilitar la telemetría anónima para este proceso
`FAILPROOFAI_NO_FIRST_RUN=1`	Omitir la configuración interactiva del primer inicio
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Omitir la auditoría local posterior a la configuración
`FAILPROOFAI_LLM_BASE_URL`	Reemplazar el endpoint compatible con OpenAI usado por las políticas LLM
`FAILPROOFAI_LLM_API_KEY`	Proporcionar la clave API utilizada por las políticas LLM
`FAILPROOFAI_LLM_MODEL`	Seleccionar el modelo utilizado por las políticas LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Limitar el tiempo de carga de módulos de políticas personalizadas
`FAILPROOFAI_NO_DOWNLOAD=1`	Rechazar la descarga de paquetes y binarios del daemon; lo que está instalado sigue aplicándose
`FAILPROOFAI_PACK_BASE_URL`	Obtener paquetes desde un mirror en lugar de `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Reemplazar las rutas de captura adicionales configuradas para un harness
`NO_COLOR`	Deshabilitar la salida de terminal en color

Las variables de home específicas del agente, como CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME y OPENCLAW_HOME, sobreescriben el lugar donde Failproof AI descubre las sesiones locales para ese harness.

Pausar o eliminar una máquina de forma segura

failproofai config --pause
failproofai config --status
failproofai config --resume

Una pausa de sesión local no deshabilita las políticas gestionadas por Cloud. Restaura los despliegues Cloud a través del flujo de trabajo de aplicación de Cloud cuando el propio despliegue es el problema. Antes de eliminar el paquete npm, elimina los hooks instalados y el daemon:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Ejecuta failproofai <command> --help para obtener detalles específicos de la versión.

Ejecuta failproofai uninstall antes de npm rm -g failproofai; npm no elimina los hooks del agente instalados ni el servicio del daemon.

Connect your agents

Reference

Configurar una máquina

Opciones de configuración

Opciones de políticas

Opciones de entrega y mantenimiento

Rutas del harness

Variables de entorno

Pausar o eliminar una máquina de forma segura

​Configurar una máquina

​Opciones de configuración

​Opciones de políticas

​Opciones de entrega y mantenimiento

​Rutas del harness

​Variables de entorno

​Pausar o eliminar una máquina de forma segura

Configurar una máquina

Opciones de configuración

Opciones de políticas

Opciones de entrega y mantenimiento

Rutas del harness

Variables de entorno

Pausar o eliminar una máquina de forma segura