Saltar al contenido principal
failproofai policies --install [policy-names...] [options]
Escribe entradas de hook en el archivo de configuración del CLI de agente instalado (Claude Code, OpenAI Codex o GitHub Copilot CLI (beta)) para que failproofai intercepte las llamadas de herramienta. Alias: failproofai p -i

Opciones

FlagDescripción
--cli claude|codex|copilotCLI(s) de agente para los que instalar; separados por espacios (p. ej. --cli claude codex copilot) o repetido. Omitir para detectar los CLIs instalados y mostrar un aviso.
--scope userInstala en el archivo de configuración de ámbito de usuario (Claude: ~/.claude/settings.json; Codex: ~/.codex/hooks.json; Copilot: ~/.copilot/hooks/failproofai.json). Por defecto.
--scope projectInstala en el archivo de configuración de ámbito de proyecto (Claude: <cwd>/.claude/settings.json; Codex: <cwd>/.codex/hooks.json; Copilot: <cwd>/.github/hooks/failproofai.json).
--scope localSolo para Claude — instala en <cwd>/.claude/settings.local.json. Codex y Copilot no tienen ámbito local.
--custom <path> / -cRuta a un archivo JS con políticas de hook personalizadas

Comportamiento

  • Sin nombres de política - abre un aviso interactivo para seleccionar políticas
  • Nombres específicos - habilita esas políticas (se añaden a las que ya estén habilitadas)
  • all - habilita todas las políticas disponibles
La instalación es acumulativa: volver a ejecutar --install agrega nuevas políticas sin eliminar las existentes.

Ejemplos

# Instalar todas las políticas predeterminadas de forma global (interactivo)
failproofai policies --install

# Instalar políticas específicas para el proyecto actual
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Habilitar todas las políticas a la vez
failproofai policies --install all

# Instalar con un archivo de políticas personalizado
failproofai policies --install --custom ./my-policies.js

# Instalar para OpenAI Codex (ámbito de proyecto)
failproofai policies --install --cli codex --scope project

# Instalar para GitHub Copilot CLI (beta) en el proyecto actual
failproofai policies --install --cli copilot --scope project

# Instalar para los tres CLIs a la vez
failproofai policies --install --cli claude codex copilot
Cuando se proporciona --custom <path>, el archivo se valida inmediatamente — debe llamar a customPolicies.add() al menos una vez. La ruta resuelta se guarda en policies-config.json como customPoliciesPath.