⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
Übersetzungen: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Laufzeit-Fehlerbehebung für Coding-Agenten. Hängt sich in Claude Code und Codex ein. Erkennt Schleifen, gefährliche Aktionen und Secret-Leaks, bevor sie zu Vorfällen werden. Keine Latenz. Läuft lokal.
Hooks für eine oder mehrere CLIs installieren:
failproofai policies --install --cli opencode pi gemini(oder--cli claude codex copilot cursor opencode pi gemini).--cliweglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen.
npm install -g failproofai
failproofai policies --install # oder einfach `failproofai` ausführen und den Erststart-Dialog bestätigen
failproofai30 integrierte Richtlinien werden sofort aktiviert. Dashboard unter localhost:8020. Den Erststart-Dialog mit FAILPROOFAI_NO_FIRST_RUN=1 deaktivieren.
| Richtlinie | Was sie blockiert |
|---|---|
block-push-master |
Direkte Pushes auf main / master |
block-force-push |
git push --force |
block-work-on-main |
Commits, Merges, Rebases auf main / master |
block-rm-rf |
Rekursives Löschen von Dateien |
sanitize-api-keys |
API-Schlüssel, die in den Agenten-Kontext gelangen |
→ Alle 30 integrierten Richtlinien
Eine Datei in .failproofai/policies/ ablegen — sie wird automatisch geladen, ohne zusätzliche Flags.
Ins Repository committen, und das gesamte Team erhält sie beim nächsten Pull.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});Drei Entscheidungen stehen jeder Richtlinie zur Verfügung:
| Entscheidung | Wirkung |
|---|---|
allow() |
Operation erlauben |
deny(message) |
Blockieren — die Nachricht wird an den Agenten zurückgegeben |
instruct(message) |
Durchlassen, aber dem nächsten Prompt des Agenten Kontext hinzufügen |
→ Anleitung für eigene Richtlinien
Jeder Tool-Aufruf des Agenten wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde, was blockiert wurde und was die Richtlinie dem Agenten mitgeteilt hat — damit keine Raterei nötig ist, wenn etwas schiefläuft. → Dashboard-Anleitung
| Erste Schritte | Installation und Einstieg |
| Integrierte Richtlinien | Alle 30 Richtlinien mit Parametern |
| Eigene Richtlinien | Eigene Richtlinien schreiben |
| Konfiguration | Konfigurationsbereiche und Zusammenführungsregeln |
| Dashboard | Sitzungsmonitor und Richtlinienaktivität |
| Architektur | Funktionsweise des Hook-Systems |
MIT mit Commons Clause — kostenlos für den internen und privaten Einsatz; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine gesonderte Vereinbarung. Den vollständigen Text finden Sie in LICENSE.
Siehe CONTRIBUTING.md. Neue Richtlinien, Randfälle und Übersetzungen sind herzlich willkommen.
Vor dem Start bauen. Zuerst
bun install && bun run buildausführen. Dieses Repository verwendet failproofais eigene Hooks auf sich selbst, und diese lösen denfailproofai-Import gegen das kompiliertedist/-Bundle auf — ohne einen Build tritt der Hook-FehlerCannot find package 'failproofai'auf. Nach Änderungen insrc/neu bauen. Siehe Build before the in-repo dev hooks will work.
Entwickelt von Nivedit Jain und Nikita Agarwal. befailproof.ai