Instalar políticas

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

Flag	Descripción
`--cli claude\|codex\|copilot`	CLI(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 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`). Por defecto.
`--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 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.

Primeros pasos

Conceptos principales

CLI

Herramientas

Avanzado

Opciones

Comportamiento

Ejemplos

​Opciones

​Comportamiento

​Ejemplos

Opciones

Comportamiento

Ejemplos