मुख्य सामग्री पर जाएं

​
आवश्यकताएं

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (वैकल्पिक - केवल स्रोत से बनाने के लिए आवश्यक)

​
इंस्टॉलेशन

npm install -g failproofai

​
त्वरित शुरुआत

1

Policies सक्षम करें

Policies ऐसे नियम हैं जो हर agent tool call से पहले और बाद में चलते हैं। ये विनाशकारी कमांड, गुप्त लीकेज, और अन्य विफलता मोड को नुकसान पहुंचाने से पहले पकड़ते हैं।
failproofai policies --install
यह Claude Code की settings.json में hook entries लिखता है। आप एकल project के लिए या विशिष्ट policies चुनकर भी इंस्टॉल कर सकते हैं:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

सत्यापन करें

failproofai policies
प्रत्येक policy दिखाता है कि वह सक्षम है या नहीं, और कोई भी कॉन्फ़िगर किए गए पैरामीटर।
3

डैशबोर्ड लॉन्च करें

failproofai
http://localhost:8020 पर एक स्थानीय डैशबोर्ड खोलता है जहां आप sessions ब्राउज़ कर सकते हैं, tool calls का निरीक्षण कर सकते हैं, और policies प्रबंधित कर सकते हैं।
4

अपने agent को चलाएं

Claude Code को सामान्य तरीके से शुरू करें। यदि agent कुछ जोखिम भरा करने का प्रयास करता है, तो failproofai इसे स्वचालित रूप से रोक देता है। इसे unattended चलने दें और डैशबोर्ड में देखें कि क्या हुआ।

​
Policies कैसे काम करती हैं

हर बार जब एक agent एक tool चलाता है, Claude Code failproofai को एक subprocess के रूप में कॉल करता है: 
Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON पढ़ता है
                                                  policies का मूल्यांकन करता है
                                                  stdout के लिए निर्णय लिखता है
प्रत्येक policy तीन निर्णयों में से एक देता है:
  • allow - agent सामान्य रूप से आगे बढ़ता है
  • deny - कार्रवाई को ब्लॉक किया जाता है, agent को बताया जाता है कि क्यों
  • instruct - agent के prompt में अतिरिक्त context जोड़ा जाता है
Policies आपकी स्थानीय प्रक्रिया में चलती हैं। कुछ भी किसी दूरस्थ सेवा को नहीं भेजा जाता है।

​
डेटा स्टोरेज

सभी configuration और logs आपकी मशीन पर रहते हैं:
पाथयह क्या संग्रहीत करता है
~/.failproofai/policies-config.jsonGlobal policy config
~/.failproofai/hook-activity.jsonlHook execution history
~/.failproofai/hook.logCustom hook errors के लिए डीबग log
.failproofai/policies-config.jsonPer-project config (committed)
.failproofai/policies-config.local.jsonव्यक्तिगत overrides (gitignored)

​
अनइंस्टॉल करना

failproofai policies --uninstall
~/.claude/settings.json से hook entries को हटाता है। ~/.failproofai/ में config files रखी जाती हैं।

​
अगले कदम

Configuration

Scopes और config file format

Built-in policies

सभी 26 policies के साथ parameters

Custom policies

JavaScript में अपनी policies लिखें

Agent monitor

Sessions की निगरानी करें और policy activity की समीक्षा करें