Instalar políticas

Ative as políticas para que sejam executadas em cada chamada de ferramenta do agente

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

Grava entradas de hook no arquivo de configurações do CLI do agente instalado (Claude Code, OpenAI Codex ou GitHub Copilot CLI (beta)) para que o failproofai intercepte as chamadas de ferramentas.

Aliases: failproofai p -i

​

Opções

Flag	Descrição
--cli claude|codex|copilot	CLI(s) do agente para instalar; separados por espaço (ex.: --cli claude codex copilot) ou repetidos. Omita para detectar os CLIs instalados e exibir um prompt.
--scope user	Instala no arquivo de configurações de escopo do usuário (Claude: ~/.claude/settings.json; Codex: ~/.codex/hooks.json; Copilot: ~/.copilot/hooks/failproofai.json). Padrão.
--scope project	Instala no arquivo de configurações de escopo do projeto (Claude: <cwd>/.claude/settings.json; Codex: <cwd>/.codex/hooks.json; Copilot: <cwd>/.github/hooks/failproofai.json).
--scope local	Apenas Claude — instala em <cwd>/.claude/settings.local.json. Codex e Copilot não possuem escopo local.
--custom <path> / -c	Caminho para um arquivo JS contendo políticas de hook personalizadas

​

Comportamento

• Sem nomes de política — abre um prompt interativo para selecionar as políticas
• Nomes específicos — ativa as políticas indicadas (adicionadas às que já estiverem ativas)
• all — ativa todas as políticas disponíveis

A instalação é aditiva: executar --install novamente adiciona novas políticas sem remover as existentes.

​

Exemplos

# Instalar todas as políticas padrão globalmente (interativo)
failproofai policies --install

# Instalar políticas específicas para o projeto atual
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Ativar todas as políticas de uma vez
failproofai policies --install all

# Instalar com um arquivo de políticas personalizado
failproofai policies --install --custom ./my-policies.js

# Instalar para OpenAI Codex (escopo de projeto)
failproofai policies --install --cli codex --scope project

# Instalar para GitHub Copilot CLI (beta) no projeto atual
failproofai policies --install --cli copilot --scope project

# Instalar para os três CLIs de uma vez
failproofai policies --install --cli claude codex copilot

Quando --custom <path> é fornecido, o arquivo é validado imediatamente — ele deve chamar customPolicies.add() pelo menos uma vez. O caminho resolvido é salvo em policies-config.json como customPoliciesPath.