Skip to content

Latest commit

 

History

History
184 lines (140 loc) · 11.4 KB

File metadata and controls

184 lines (140 loc) · 11.4 KB

⚠️ 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 | 🇸🇦 العربية | 🇮🇱 עברית


failproof ai

npm CI Supply Chain Slack Docs License

अनुवाद: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

कोडिंग एजेंट्स के लिए रनटाइम फेलियर रेजोल्यूशन। Claude Code और Codex में हुक करता है। लूप्स, खतरनाक क्रियाओं, और सीक्रेट लीक्स को घटना बनने से पहले पकड़ता है। जीरो लेटेंसी। स्थानीय रूप से चलता है।

Failproof AI in action


समर्थित एजेंट CLIs

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

एक या कई के लिए हुक इंस्टॉल करें: failproofai policies --install --cli opencode pi gemini (या --cli claude codex copilot cursor opencode pi gemini)। स्वचालित रूप से इंस्टॉल किए गए CLIs का पता लगाने और प्रॉम्प्ट करने के लिए --cli छोड़ दें।


इंस्टॉल करें

npm install -g failproofai
failproofai policies --install   # या बस `failproofai` चलाएं और पहली बार के प्रॉम्प्ट को स्वीकार करें
failproofai

30 बिल्ट-इन पॉलिसीज तुरंत सक्रिय हो जाती हैं। डैशबोर्ड localhost:8020 पर है। FAILPROOFAI_NO_FIRST_RUN=1 से पहली बार के प्रॉम्प्ट को अक्षम करें।


यह क्या रोकता है

पॉलिसी यह क्या ब्लॉक करता है
block-push-master main / master में सीधे पुश
block-force-push git push --force
block-work-on-main main / master पर कमिट, मर्ज, रीबेस
block-rm-rf पुनरावर्ती फ़ाइल विलोपन
sanitize-api-keys एजेंट संदर्भ में API कुंजी लीक होना

सभी 30 बिल्ट-इन पॉलिसीज


आपकी अपनी पॉलिसीज

.failproofai/policies/ में एक फ़ाइल डालें — यह स्वचालित रूप से लोड होती है, कोई फ्लैग की आवश्यकता नहीं है। इसे कमिट करें और पूरी टीम को अगले पुल पर मिल जाएगा।

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();
  },
});

हर पॉलिसी के लिए तीन निर्णय उपलब्ध हैं:

निर्णय प्रभाव
allow() ऑपरेशन की अनुमति दें
deny(message) इसे ब्लॉक करें — संदेश एजेंट को वापस जाता है
instruct(message) इसे पास करें, लेकिन एजेंट के अगले प्रॉम्प्ट में संदर्भ जोड़ें

कस्टम पॉलिसीज गाइड


सेशन दृश्यमानता

आपके एजेंट द्वारा किया जाने वाला हर टूल कॉल स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला, क्या ब्लॉक किया गया, और पॉलिसी ने एजेंट को क्या कहा — इसलिए आप अनुमान नहीं लगा रहे हैं जब कुछ गलत हो जाता है। → डैशबोर्ड गाइड


दस्तावेज़

शुरुआत करना इंस्टॉलेशन और पहले कदम
बिल्ट-इन पॉलिसीज सभी 30 पॉलिसीज पैरामीटर के साथ
कस्टम पॉलिसीज अपना लिखें
कॉन्फ़िगरेशन कॉन्फ़िग स्कोप और मर्ज नियम
डैशबोर्ड सेशन मॉनिटर और पॉलिसी गतिविधि
आर्किटेक्चर हुक सिस्टम कैसे काम करता है

लाइसेंस

MIT with Commons Clause — आंतरिक और व्यक्तिगत उपयोग के लिए निःशुल्क; failproofai के वाणिज्यिक पुनर्विक्रय के लिए एक अलग समझौते की आवश्यकता है। पूरे पाठ के लिए LICENSE देखें।


योगदान

CONTRIBUTING.md देखें। नई पॉलिसीज, किनारे के मामले, और अनुवाद सभी का स्वागत है।

शुरू करने से पहले बिल्ड करें। पहले bun install && bun run build चलाएं। यह रिपो failproofai की अपनी हुक्स को अपने आप पर चलाता है, और वे failproofai आयात को संकलित dist/ बंडल के विरुद्ध समाधान करते हैं — बिल्ड के बिना आप Cannot find package 'failproofai' हुक त्रुटि से टकराएंगे। src/ में परिवर्तन के बाद पुनः बिल्ड करें। देखें बिल्ड करें ताकि रेपो-में डेव हुक्स काम करेंगे


Nivedit Jain और Nikita Agarwal द्वारा निर्मित। befailproof.ai