Instalar políticas

failproofai policies --install [policy-names...] [options]

Escribe entradas de hooks en el archivo de configuración del agente CLI instalado (Claude Code, OpenAI Codex o GitHub Copilot CLI (beta)) para que failproofai intercepte las llamadas de herramientas. Alias: failproofai p -i

Opciones

Flag	Descripción
`--cli claude\|codex\|copilot`	CLI(s) del agente en los que instalar; separados por espacio (p. ej. `--cli claude codex copilot`) o repetidos. Si se omite, detecta los CLIs instalados y solicita confirmación.
`--scope user`	Instala en el archivo de configuración de ámbito de usuario (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Valor predeterminado.
`--scope project`	Instala 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 local`	Solo para Claude — instala en `<cwd>/.claude/settings.local.json`. Codex y Copilot no tienen ámbito `local`.
`--custom <path>` / `-c`	Ruta a un archivo JS que contiene políticas de hooks personalizadas

Comportamiento

Sin nombres de política — abre un selector interactivo para elegir políticas
Nombres específicos — habilita esas políticas (se añaden a las ya habilitadas)
all — habilita todas las políticas disponibles

La instalación es acumulativa: ejecutar --install de nuevo añade nuevas políticas sin eliminar las existentes.

Ejemplos

# Instalar todas las políticas predeterminadas globalmente (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 de una 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 de inmediato — debe llamar a customPolicies.add() al menos una vez. La ruta resuelta se guarda en policies-config.json como customPoliciesPath.

Primeros pasos

Conceptos principales

CLI

Herramientas

Avanzado

Ejemplos

Opciones

Comportamiento

Ejemplos

​Opciones

​Comportamiento

​Ejemplos

Opciones

Comportamiento

Ejemplos