Instalar políticas

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.

Começando

Conceitos principais

CLI

Ferramentas

Avançado

Opções

Comportamento

Exemplos

​Opções

​Comportamento

​Exemplos

Opções

Comportamento

Exemplos