शुरुआत करें

आवश्यकताएं

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

इंस्टॉलेशन

npm install -g failproofai

bun add -g failproofai

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

Policies को सक्षम करें

Policies नियम हैं जो हर agent tool call से पहले और बाद में चलते हैं। ये विनाशकारी commands, secret leakage, और अन्य failure modes को नुकसान पहुंचने से पहले पकड़ते हैं।

failproofai policies --install

यह आपके इंस्टॉल किए गए agent CLIs में hook entries लिखता है (Claude Code के ~/.claude/settings.json, OpenAI Codex के ~/.codex/hooks.json, GitHub Copilot CLI के ~/.copilot/hooks/failproofai.json, Cursor Agent के ~/.cursor/hooks.json, OpenCode के generated plugin shim में ~/.config/opencode/plugins/failproofai.mjs plus ~/.config/opencode/opencode.json के plugin array में एक registration entry, Pi के ~/.pi/agent/settings.json, या Hermes के ~/.hermes/config.yaml)। जब एक से अधिक मौजूद हों तो आपसे prompt किया जाएगा; prompt को छोड़ने के लिए --cli claude codex copilot cursor opencode pi hermes (कोई भी subset) पास करें।GitHub Copilot CLI, Cursor Agent, OpenCode, और Pi सपोर्ट beta है — --cli copilot, --cli cursor, --cli opencode, या --cli pi के साथ इंस्टॉल करें। Hermes (hermes-agent, एक Slack/Telegram gateway) user-scope के साथ --cli hermes के साथ इंस्टॉल होता है और साथ ही एक offline audit source है।

failproofai policies --install --scope project
failproofai policies --install --cli codex --scope project
failproofai policies --install --cli copilot --scope project
failproofai policies --install --cli cursor --scope project
failproofai policies --install --cli opencode --scope project
failproofai policies --install --cli pi --scope project
failproofai policies --install --cli hermes --scope user
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys

सत्यापित करें

failproofai policies

हर policy दिखाता है, चाहे वह सक्षम हो, और कोई भी configured parameters।

Dashboard लॉन्च करें

failproofai

http://localhost:8020 पर एक local dashboard खोलता है जहां आप sessions को ब्राउज कर सकते हैं, tool calls की जांच कर सकते हैं, और policies को manage कर सकते हैं।

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

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

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

हर बार जब एक agent किसी tool को चलाता है, Claude Code failproofai को एक subprocess के रूप में कॉल करता है:

Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON पढ़ता है
                                                 policies का मूल्यांकन करता है
                                                 stdout पर निर्णय लिखता है

प्रत्येक policy तीन निर्णयों में से एक देता है:

allow - agent सामान्य रूप से आगे बढ़ता है
deny - कार्रवाई को ब्लॉक किया जाता है, agent को बताया जाता है कि क्यों
instruct - agent के prompt में extra context जोड़ा जाता है

Policies आपकी local process में चलती हैं। कुछ भी remote service को नहीं भेजा जाता है।

Convention-based policies के साथ team policies सेट अप करें

अपनी team के across quality standards स्थापित करने का सबसे तेज़ तरीका .failproofai/policies/ convention है। इस directory में policy files डालें और वे automatically लोड हो जाती हैं — कोई flags नहीं, कोई config changes नहीं, कोई install commands नहीं।

Policies directory बनाएं

mkdir -p .failproofai/policies

Policy files जोड़ें

Starter examples को कॉपी करें या अपने स्वयं के लिखें:

cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/

या एक नया बनाएं:

// .failproofai/policies/team-policies.mjs
import { customPolicies, allow, deny, instruct } from "failproofai";

customPolicies.add({
  name: "test-before-commit",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Bash") return allow();
    if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
      return instruct("Run tests before committing.");
    }
    return allow();
  },
});

Git को commit करें

git add .failproofai/policies/
git commit -m "Add team quality policies"

हर team member जिसके पास failproofai इंस्टॉल है, ये policies automatically pick up करता है। कोई per-developer setup की आवश्यकता नहीं है।

अपने repo में .failproofai/policies/ को commit करें ताकि पूरी team एक ही standards शेयर करे। जैसे-जैसे आपकी team नए failure modes को discover करती है, policies को जोड़ें और push करें — हर कोई अपने अगले git pull पर update प्राप्त करता है। समय के साथ ये policies एक living quality standard बन जाती हैं जो बेहतर होती रहती हैं।

डेटा स्टोरेज

सभी configuration और logs आपकी machine पर रहते हैं:

Path	क्या स्टोर करता है
`~/.failproofai/policies-config.json`	Global policy config
`~/.failproofai/hook-activity.jsonl`	Hook execution history
`~/.failproofai/hook.log`	Custom hook errors के लिए debug log
`.failproofai/policies-config.json`	Per-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 with parameters

Custom policies

JavaScript में अपनी स्वयं की policies लिखें

Agent monitor

Sessions को monitor करें और policy activity की समीक्षा करें

शुरू करें

मूल अवधारणाएँ

CLI

उपकरण

उन्नत

उदाहरण

शुरुआत करें

आवश्यकताएं

इंस्टॉलेशन

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

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

Convention-based policies के साथ team policies सेट अप करें

डेटा स्टोरेज

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

अगले कदम

Configuration

Built-in policies

Custom policies

Agent monitor

​आवश्यकताएं

​इंस्टॉलेशन

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

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

​Convention-based policies के साथ team policies सेट अप करें

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

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

​अगले कदम

Configuration

Built-in policies

Custom policies

Agent monitor

आवश्यकताएं

इंस्टॉलेशन

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

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

Convention-based policies के साथ team policies सेट अप करें

डेटा स्टोरेज

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

अगले कदम