Pular para o conteúdo principal
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

FlagDescrição
--cli claude|codex|copilotCLI(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 userInstala 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 projectInstala 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 localApenas Claude — instala em <cwd>/.claude/settings.local.json. Codex e Copilot não possuem escopo local.
--custom <path> / -cCaminho 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.