> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof AI CLI > Instala hooks, gestiona políticas locales, conecta a Cloud y opera el demonio local. Instala la CLI local con `npm install -g failproofai`. Ejecútala 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 fuente. `failproofai configure` y `failproofai setup` son alias de `failproofai config`; `failproofai p` es un alias de `failproofai policies`. ## Configurar una máquina ```bash theme={null} npm install -g failproofai failproofai config \ --connect https://app.befailproof.ai \ --token \ --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` | Ejecuta la configuración interactiva de la máquina | | `failproofai config --connect --token ` | Conecta la ingesta Cloud y la entrega de políticas | | `failproofai config --status` | Muestra el estado de la conexión, el demonio, la entrega y la pausa | | `failproofai policies` | Lista las políticas integradas y personalizadas | | `failproofai policies --install` | Instala hooks y habilita políticas | | `failproofai policy add ` | Habilita una política integrada | | `failproofai policy remove ` | Deshabilita una política integrada | | `failproofai policies --uninstall` | Deshabilita políticas o elimina los hooks del harness | | `failproofai audit` | Analiza el historial local del agente y abre la vista de auditoría local | | `failproofai audit --schedule [days] --email
` | Programa análisis locales recurrentes y envía sus resultados por correo | | `failproofai audit --status` | Muestra la dirección del informe, el intervalo y el próximo análisis programado | | `failproofai audit --no-schedule` | Detiene los análisis recurrentes sin eliminar el historial de auditoría | | `failproofai harness list` | Lista las rutas de captura adicionales | | `failproofai flush --wait` | Entrega el spool de eventos actual | | `failproofai backfill --since 30d` | Vuelve a leer el historial previamente procesado | | `failproofai config --pause [duration]` | Pausa una sesión local durante 30 minutos por defecto, hasta 8 horas | | `failproofai config --resume` | Reanuda una sesión local pausada; añade `--all` para limpiar todas las pausas | | `failproofai update` | Completa las migraciones del paquete y actualiza el demonio | | `failproofai migrate --dry-run` | Previsualiza o ejecuta las migraciones de diseño del directorio home pendientes | | `failproofai uninstall` | Elimina los hooks y el demonio antes de desinstalar el paquete | | `failproofai --version` | Muestra la versión del paquete instalado | | `failproofai --help` | Muestra los comandos y el uso global | ## Flags de configuración | Flag | Uso | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `--connect --token ` | Conecta de forma no interactiva | | `--machine-id ` | Establece el ID estable de la máquina | | `--machine-label ` | Establece o cambia la etiqueta del panel | | `--no-transcripts` | Envía decisiones sin el contenido de la transcripción | | `--disconnect` | Detiene las extracciones de políticas Cloud y la entrega de eventos | | `--status` | Muestra el estado actual de la máquina | | `--pause [duration]` | Pausa la sesión más reciente en el directorio actual; acepta segundos, minutos u horas y tiene un valor por defecto de 30 minutos | | `--resume` | Finaliza una pausa coincidente antes de tiempo | | `--session ` | Apunta a una sesión explícita para pausar o reanudar | | `--all` | Junto con `--resume`, finaliza todas las pausas activas | Las pausas locales suspenden las políticas integradas, personalizadas y de convención para una sesión. Siempre expiran y no deshabilitan las políticas gestionadas por Cloud. `block-self-pause` impide que un agente instrumentado use este mecanismo de escape por sí mismo. ## Flags de políticas | Flag | Uso | | ----------------------------------- | -------------------------------------------------------------- | | `--install`, `-i` | Habilita políticas e instala hooks del harness | | `--uninstall`, `-u` | Deshabilita políticas o elimina hooks | | `--cli ` | Apunta a uno o más harnesses compatibles | | `--scope user\|project\|local\|all` | Elige el ámbito de configuración; `all` es para desinstalar | | `--beta` | Incluye políticas en versión beta | | `--custom`, `-c ` | Valida y carga un archivo de política personalizada; repetible | ## Flags de entrega y mantenimiento | Comando | Flags | | ----------- | -------------------------------------------- | | `backfill` | `--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run` | | `flush` | `--wait`, `--timeout ` | | `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 diseño del directorio home, instala el binario del demonio correspondiente y reinicia el servicio. `--no-daemon` solo realiza la migración del diseño. ## Rutas de harness ```text theme={null} failproofai harness list [harness] failproofai harness add-path [label=] failproofai harness remove-path ``` 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 recolección duplicada o corrupción del cursor. La configuración de rutas adicionales se recarga sin necesidad de reiniciar el demonio. Los entornos de contenedor pueden reemplazar las rutas adicionales configuradas en archivos con una variable separada por comas llamada `FAILPROOFAI__EXTRA_PATHS`, por ejemplo: ```bash theme={null} 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` | Reubica el diseño completo de `~/.failproofai` | | `FAILPROOFAI_LOG_LEVEL` | Establece la verbosidad del registro local | | `FAILPROOFAI_HOOK_LOG_FILE` | Escribe diagnósticos de hooks en un archivo seleccionado | | `FAILPROOFAI_TELEMETRY_DISABLED=1` | Deshabilita la telemetría anónima para este proceso | | `FAILPROOFAI_NO_FIRST_RUN=1` | Omite la configuración interactiva del primer arranque | | `FAILPROOFAI_NO_AUTO_AUDIT=1` | Omite la auditoría local posterior a la configuración | | `FAILPROOFAI_LLM_BASE_URL` | Reemplaza el endpoint compatible con OpenAI usado por las políticas LLM | | `FAILPROOFAI_LLM_API_KEY` | Proporciona la clave API usada por las políticas LLM | | `FAILPROOFAI_LLM_MODEL` | Selecciona el modelo usado por las políticas LLM | | `FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS` | Limita la carga del módulo de políticas personalizadas | | `FAILPROOFAI__EXTRA_PATHS` | Reemplaza las rutas de captura adicionales configuradas para un harness | | `NO_COLOR` | Deshabilita la salida de terminal con colores | Las variables de directorio home específicas del agente, como `CLAUDE_PROJECTS_PATH`, `CURSOR_HOME`, `HERMES_HOME` y `OPENCLAW_HOME`, anulan la ubicación donde Failproof AI descubre las sesiones locales para ese harness. ## Pausar o eliminar una máquina de forma segura ```bash theme={null} 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 de 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 demonio: ```bash theme={null} failproofai uninstall --dry-run failproofai uninstall --yes npm rm -g failproofai ``` Ejecuta `failproofai --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 demonio.