Installa policy

Abilita le policy in modo che vengano eseguite su ogni chiamata tool dell’agent

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

Scrive voci hook nel file di impostazioni della CLI dell’agent installata (Claude Code, OpenAI Codex o GitHub Copilot CLI (beta)) in modo che failproofai intercetti le chiamate tool.

Alias: failproofai p -i

​

Opzioni

Flag	Descrizione
--cli claude|codex|copilot	CLI(s) dell’agent per cui installare; separate da spazio (es. --cli claude codex copilot) o ripetute. Ometti per rilevare automaticamente le CLI installate e ricevere una richiesta.
--scope user	Installa nel file di impostazioni con scope utente (Claude: ~/.claude/settings.json; Codex: ~/.codex/hooks.json; Copilot: ~/.copilot/hooks/failproofai.json). Predefinito.
--scope project	Installa nel file di impostazioni con scope progetto (Claude: <cwd>/.claude/settings.json; Codex: <cwd>/.codex/hooks.json; Copilot: <cwd>/.github/hooks/failproofai.json).
--scope local	Solo Claude — installa in <cwd>/.claude/settings.local.json. Codex e Copilot non hanno uno scope local.
--custom <path> / -c	Percorso a un file JS contenente policy hook personalizzate

​

Comportamento

• Nessun nome di policy - apre un prompt interattivo per selezionare le policy
• Nomi specifici - abilita quelle policy (aggiunte a quelle già abilitate)
• all - abilita tutte le policy disponibili

L’installazione è additiva: eseguire --install di nuovo aggiunge nuove policy senza rimuovere quelle esistenti.

​

Esempi

# Installa tutte le policy predefinite globalmente (interattivo)
failproofai policies --install

# Installa policy specifiche per il progetto corrente
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Abilita tutte le policy in una volta
failproofai policies --install all

# Installa con un file di policy personalizzate
failproofai policies --install --custom ./my-policies.js

# Installa per OpenAI Codex (scope progetto)
failproofai policies --install --cli codex --scope project

# Installa per GitHub Copilot CLI (beta) per il progetto corrente
failproofai policies --install --cli copilot --scope project

# Installa per tutte e tre le CLI in una volta
failproofai policies --install --cli claude codex copilot

Quando --custom <path> è fornito, il file viene convalidato immediatamente - deve chiamare customPolicies.add() almeno una volta. Il percorso risolto viene salvato in policies-config.json come customPoliciesPath.