Zum Hauptinhalt springen
failproofai policies --install [policy-names...] [options]
Schreibt Hook-Einträge in die Einstellungsdatei der installierten Agent-CLI (Claude Code, OpenAI Codex oder GitHub Copilot CLI (Beta)), damit failproofai Tool-Aufrufe abfängt. Aliase: failproofai p -i

​
Optionen

FlagBeschreibung
--cli claude|codex|copilotAgent-CLI(s), für die installiert werden soll; leerzeichen-getrennt (z. B. --cli claude codex copilot) oder mehrfach angegeben. Weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen.
--scope userInstalliert in die benutzerweite Einstellungsdatei (Claude: ~/.claude/settings.json; Codex: ~/.codex/hooks.json; Copilot: ~/.copilot/hooks/failproofai.json). Standard.
--scope projectInstalliert in die projektweite Einstellungsdatei (Claude: <cwd>/.claude/settings.json; Codex: <cwd>/.codex/hooks.json; Copilot: <cwd>/.github/hooks/failproofai.json).
--scope localNur Claude — installiert in <cwd>/.claude/settings.local.json. Codex und Copilot unterstützen keinen local-Scope.
--custom <path> / -cPfad zu einer JS-Datei mit benutzerdefinierten Hook-Richtlinien

​
Verhalten

  • Keine Richtliniennamen – öffnet eine interaktive Auswahl zum Wählen von Richtlinien
  • Bestimmte Namen – aktiviert diese Richtlinien (werden zu bereits aktivierten hinzugefügt)
  • all – aktiviert alle verfügbaren Richtlinien
Die Installation ist additiv: erneutes Ausführen von --install fügt neue Richtlinien hinzu, ohne bestehende zu entfernen.

​
Beispiele

# Alle Standard-Richtlinien global installieren (interaktiv)
failproofai policies --install

# Bestimmte Richtlinien für das aktuelle Projekt installieren
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Alle Richtlinien auf einmal aktivieren
failproofai policies --install all

# Mit einer benutzerdefinierten Richtliniendatei installieren
failproofai policies --install --custom ./my-policies.js

# Für OpenAI Codex installieren (Projekt-Scope)
failproofai policies --install --cli codex --scope project

# Für GitHub Copilot CLI (Beta) im aktuellen Projekt installieren
failproofai policies --install --cli copilot --scope project

# Für alle drei CLIs gleichzeitig installieren
failproofai policies --install --cli claude codex copilot
Wenn --custom <path> angegeben wird, wird die Datei sofort validiert – sie muss mindestens einmal customPolicies.add() aufrufen. Der aufgelöste Pfad wird als customPoliciesPath in policies-config.json gespeichert.