Failproof AI CLI

npm install -g failproofai के साथ स्थानीय CLI को इंस्टॉल करें। इसे बिना किसी तर्क के चलाएं ताकि स्थानीय नीति डैशबोर्ड खुल जाए। पैकेज को Node.js 20.9 या नए संस्करण की आवश्यकता है। Bun 1.3 या नए संस्करण का विकास और स्रोत इंस्टॉल के लिए समर्थन किया जाता है। failproofai configure और failproofai setup , failproofai config के लिए उपनाम हैं। failproofai policy , failproofai pack और failproofai p सभी failproofai policies की वर्तनी हैं — पैक और एकल नीतियां एक विचार के लिए तीन कमांड थीं और अब एक हैं। पुरानी वर्तनी अभी भी काम करती है, दो अपवादों के साथ: pack list <source> अब policies show <source> है, और pack build अब publish है।

एक मशीन सेट अप करें

CLI को इंस्टॉल करें, फिर मशीन की कुंजी को शेल में पढ़ें। read -s इसे एक संकेत पर लेता है जो गूंजता नहीं है, इसलिए यह कभी एक कमांड में दिखाई नहीं देता:

npm install -g failproofai
read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

फिर मशीन को सेट अप करें और चुनें कि यह क्या लागू करता है:

failproofai config
failproofai policies add FailproofAI/policies
failproofai config --status

failproofai config पूरा सेटअप है: यह failproofaid सेवा को इंस्टॉल करता है (रूट एक बार, sudo -n के माध्यम से — कभी भी एक इंटरेक्टिव पासवर्ड प्रॉम्प्ट नहीं), हर एजेंट CLI में हुक डालता है जो वह पाता है, और जब एक कुंजी उपलब्ध हो तो Cloud से कनेक्ट करता है। टर्मिनल के बिना — CI, एक कंटेनर, एक एजेंट इसे चला रहा है — यह पूछने के बजाय लागू करता है, और यदि इसे जो करने के लिए कहा गया था वह नहीं हुआ तो 1 से बाहर निकलता है। यह कोई भी नीतियां नहीं चुनता है। वह दूसरी कमांड का काम है, और इसके बिना एक नई तरह से कॉन्फ़िगर की गई मशीन हमेशा चालू गार्ड को छोड़कर कुछ भी लागू नहीं करती है। --token पर पर्यावरण चर को प्राथमिकता दें: एक कमांड-लाइन तर्क बॉक्स पर हर उपयोगकर्ता द्वारा ps से पठनीय है। यह सब चर की रक्षा करता है — किसी भी कमांड में टाइप की गई कुंजी, export सहित, अभी भी शेल इतिहास में उतरती है, जिसीलिए इसे ऊपर read -s के साथ पढ़ा जाता है। CI में, इसे गुप्त स्टोर से सेट करें और शेल ट्रेसिंग (set -x) को बंद रखें, अन्यथा ट्रेस इसे प्रिंट करता है।

--connect <url> एक मशीन को नामांकित करता है जो पहले से ही सेट अप है। यह नामांकन सफल होने के तुरंत बाद लौटता है — यह डेमन को इंस्टॉल नहीं करता है और किसी भी हुक को नहीं डालता है। एक मशीन पर सादा failproofai config (या failproofai config --token <key>) का उपयोग करें जो अभी तक सेट अप नहीं किया गया है, अन्यथा यह कुछ भी एकत्र और लागू न करते हुए जुड़ा हुआ दिखाई देगा।

स्थानीय नीति डैशबोर्ड खोलने के लिए failproofai को बिना किसी तर्क के चलाएं।

कमांड	परिणाम
`failproofai config`	मशीन को सेट अप करें: एजेंट, डेमन, और जब कुंजी मौजूद हो तो Cloud
`failproofai config --token <key>`	एक पास में सेट अप करें और कनेक्ट करें, कुछ भी पूछे बिना
`failproofai config --connect <url>`	एक मशीन को नामांकित करें जो पहले से ही सेट अप है — कोई डेमन नहीं, कोई हुक नहीं
`failproofai config --status`	कनेक्शन, डेमन, डिलीवरी, और पॉज़ स्थिति दिखाएं
`failproofai policies`	बिल्ट-इन, कस्टम, सम्मेलन, पैक, और Cloud-प्रबंधित नीतियां सूचीबद्ध करें
`failproofai policies --install`	अपने एजेंट CLIs में हुक डालें। अपने आप पर कोई नीति सक्षम नहीं करता है
`failproofai policies add <name>`	एक नीति सक्षम करें — एक बिल्ट-इन, या एक स्थापित पैक से `<pack-id>:<name>`
`failproofai policies remove <name>`	एक नीति अक्षम करें, समान नामकरण
`failproofai policies --uninstall`	नीतियों को अक्षम करें या हार्नेस हुक हटाएं
`failproofai policies show <owner>/<repo>`	एक पैक क्या ले जाता है, इसके मैनिफेस्ट से पढ़ा जाता है, इसे लेने से पहले
`failproofai policies show <owner>/<repo> --releases`	हर संस्करण जो इसने प्रकाशित किया है, और कौन सा यहां है
`failproofai policies add <source>`	GitHub रिलीज़ से एक नीति पैक इंस्टॉल करें; कोई टैग नहीं नए को लेता है और इसे पिन करता है
`failproofai publish`	अपनी नीतियों को एक पैक के रूप में भेजें; `--init` एक को शुरू करने के लिए लिखता है
`failproofai policies remove <publisher/name>`	एक पैक अनइंस्टॉल करें
`failproofai audit`	स्थानीय एजेंट इतिहास को स्कैन करें और स्थानीय ऑडिट दृश्य खोलें
`failproofai audit --schedule [days] --email <address>`	आवर्ती स्थानीय स्कैन शेड्यूल करें और उनके निष्कर्षों को ईमेल करें
`failproofai audit --status`	रिपोर्ट पता, अंतराल, और अगली निर्धारित स्कैन दिखाएं
`failproofai audit --no-schedule`	आडिट इतिहास को हटाए बिना आवर्ती स्कैन बंद करें
`failproofai harness list`	अतिरिक्त कैप्चर पाथ सूचीबद्ध करें
`failproofai flush --wait`	वर्तमान इवेंट स्पूल डिलीवर करें
`failproofai backfill --since 30d`	पहले पारित इतिहास को फिर से पढ़ें
`failproofai config --pause [duration]`	एक स्थानीय सत्र को डिफ़ॉल्ट रूप से 30 मिनट के लिए पॉज़ करें, 8 घंटे तक
`failproofai config --resume`	एक पॉज़ किए गए स्थानीय सत्र को फिर से शुरू करें; सभी पॉज़ को साफ़ करने के लिए `--all` जोड़ें
`failproofai update`	पैकेज माइग्रेशन समाप्त करें और डेमन को अपडेट करें
`failproofai migrate --dry-run`	लंबित होम-लेआउट माइग्रेशन की पूर्वावलोकन या चलाएं
`failproofai uninstall`	पैकेज को हटाने से पहले हुक और डेमन हटाएं
`failproofai --version`	स्थापित पैकेज संस्करण प्रिंट करें
`failproofai --help`	कमांड और वैश्विक उपयोग दिखाएं

कॉन्फ़िगरेशन फ़्लैग

फ़्लैग	उपयोग
`--token <key>`	गैर-इंटरेक्टिवली सेट अप और कनेक्ट करें; `FAILPROOFAI_CLOUD_TOKEN` से भी पढ़ें
`--url <url>`	`app.befailproof.ai` के अलावा कहीं और कनेक्ट करें; `FAILPROOFAI_CLOUD_URL` से भी पढ़ें
`--connect <url>`	केवल नामांकन, एक पहले से ही सेट अप की गई मशीन पर। डेमन और हर हुक को छोड़ देता है
`--machine-id <id>`	स्थिर मशीन आईडी सेट करें
`--machine-label <name>`	एक मशीन को तोड़ना जो पहले से ही जुड़ी हुई है। अपने आप पर यह कभी भी सेटअप नहीं चलाता है, इसलिए इसे `failproofai config` के बाद दें, सेटअप के दौरान नहीं
`--no-transcripts`	प्रतिलिपि सामग्री के बिना निर्णय भेजें
`--disconnect`	Cloud नीति पुल और ईवेंट डिलीवरी बंद करें
`--status`	वर्तमान मशीन स्थिति दिखाएं
`--pause [duration]`	वर्तमान निर्देशिका में नए सत्र को पॉज़ करें; सेकंड, मिनट, या घंटे स्वीकार करता है और डिफ़ॉल्ट रूप से 30 मिनट है
`--resume`	एक मिलती पॉज़ को जल्दी समाप्त करें
`--session <id>`	पॉज़ या रिज़्यूम के लिए एक स्पष्ट सत्र को लक्ष्य करें
`--all`	`--resume` के साथ, हर सक्रिय पॉज़ को समाप्त करें

स्थानीय पॉज़ एक सत्र के लिए बिल्ट-इन, कस्टम, सम्मेलन, और पैक नीतियों को निलंबित करते हैं। वे हमेशा समाप्त होते हैं और Cloud-प्रबंधित नीतियों को अक्षम नहीं करते हैं। block-failproofai-commands — जो हमेशा चालू है और अपने आप को अक्षम या पॉज़ नहीं किया जा सकता है — एक उपकरणित एजेंट को इस बचाव हैच को स्वयं उपयोग करने से रोकता है।

नीति फ़्लैग

फ़्लैग	उपयोग
`--install`, `-i`	हार्नेस हुक इंस्टॉल करें। इसके बाद के नाम उन नीतियों को सक्षम करते हैं; कोई नहीं होने पर, कोई नीति परिवर्तन नहीं
`--uninstall`, `-u`	नीतियों को अक्षम करें या हुक हटाएं
`--cli <names...>`	एक या अधिक समर्थित हार्नेस को लक्ष्य करें
`--scope user\|project\|local\|all`	कॉन्फ़िगरेशन स्कोप चुनें; `all` अनइंस्टॉल के लिए है
`--beta`	बीटा नीतियां शामिल करें
`--custom`, `-c <path>`	एक कस्टम नीति फ़ाइल को मान्य करें और लोड करें; दोहराया जा सकता है

डिलीवरी और रखरखाव फ़्लैग

कमांड	फ़्लैग
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update को npm install -g failproofai@latest के बाद चलाया जाना चाहिए; यह होम-लेआउट माइग्रेशन करता है, मेल खाने वाले डेमन बाइनरी को इंस्टॉल करता है, और सेवा को पुनरारंभ करता है। --no-daemon केवल लेआउट माइग्रेशन करता है।

हार्नेस पाथ

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

समर्थित हार्नेस नाम claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, और goose हैं। लेबल व्युत्पन्न एजेंट आईडी को नेमस्पेस करते हैं जब दो रूट एक ही परियोजना की प्रतियां रखते हैं। ओवरलैपिंग रूट और डुप्लिकेट लेबल को डुप्लिकेट संग्रह या कर्सर भ्रष्टाचार को रोकने के लिए अस्वीकार कर दिया जाता है। अतिरिक्त-पाथ कॉन्फ़िगरेशन डेमन पुनरारंभ के बिना पुनः लोड करता है। कंटेनर वातावरण फ़ाइल-कॉन्फ़िगर किए गए अतिरिक्त पाथों को FAILPROOFAI_<HARNESS>_EXTRA_PATHS नाम के एक अल्पविराम-पृथक चर के साथ बदल सकते हैं, उदाहरण के लिए:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

पर्यावरण चर

स्थायी मशीन व्यवहार के लिए कॉन्फ़िगरेशन फ़ाइलों का उपयोग करें। पर्यावरण चर कंटेनर, परीक्षण, और एक प्रक्रिया के लिए सबसे उपयोगी हैं।

चर	उपयोग
`FAILPROOFAI_CLOUD_TOKEN`	Cloud कुंजी, `--token` की बजाय। इसे प्राथमिकता दें: एक तर्क `ps` से हर उपयोगकर्ता द्वारा पठनीय है। इसे `read -s` या CI गुप्त स्टोर से सेट करें, कभी भी कुंजी को एक कमांड में टाइप करके नहीं, जो किसी भी तरह से शेल इतिहास में आती है
`FAILPROOFAI_CLOUD_URL`	Cloud URL, `--url` की बजाय। वही चर जो डेमन पढ़ता है
`FAILPROOFAI_HOME`	संपूर्ण `~/.failproofai` लेआउट को स्थानांतरित करें
`FAILPROOFAI_LOG_LEVEL`	स्थानीय लॉगिंग वर्बोसिटी सेट करें
`FAILPROOFAI_HOOK_LOG_FILE`	हुक डायग्नोस्टिक्स को एक चयनित फ़ाइल में लिखें
`FAILPROOFAI_TELEMETRY_DISABLED=1`	इस प्रक्रिया के लिए अनाम टेलीमेट्री को अक्षम करें
`FAILPROOFAI_NO_FIRST_RUN=1`	इंटरेक्टिव पहली रन सेटअप को छोड़ें
`FAILPROOFAI_NO_AUTO_AUDIT=1`	पोस्ट-सेटअप स्थानीय ऑडिट को छोड़ें
`FAILPROOFAI_LLM_BASE_URL`	LLM नीतियों द्वारा उपयोग किए जाने वाले OpenAI-संगत अंतिम बिंदु को ओवरराइड करें
`FAILPROOFAI_LLM_API_KEY`	LLM नीतियों द्वारा उपयोग की जाने वाली API कुंजी की आपूर्ति करें
`FAILPROOFAI_LLM_MODEL`	LLM नीतियों द्वारा उपयोग किए गए मॉडल का चयन करें
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	कस्टम नीति मॉड्यूल लोडिंग को बांधें
`FAILPROOFAI_NO_DOWNLOAD=1`	पैक और डेमन बाइनरी प्राप्त करने से मना करें; जो स्थापित है वह लागू करना रखता है
`FAILPROOFAI_PACK_BASE_URL`	`github.com` की बजाय एक मिरर से पैक प्राप्त करें
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	एक हार्नेस के लिए कॉन्फ़िगर किए गए अतिरिक्त कैप्चर पाथ को प्रतिस्थापित करें
`NO_COLOR`	रंगीन टर्मिनल आउटपुट को अक्षम करें

एजेंट-विशिष्ट होम चर जैसे CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME, और OPENCLAW_HOME को ओवरराइड करते हैं कि Failproof AI उस हार्नेस के लिए स्थानीय सत्र की खोज कहां करता है।

एक मशीन को सुरक्षित रूप से पॉज़ या हटाएं

failproofai config --pause
failproofai config --status
failproofai config --resume

एक स्थानीय सत्र पॉज़ Cloud-प्रबंधित नीतियों को अक्षम नहीं करता है। जब रोलआउट ही समस्या हो तो Cloud विज्ञापन वर्कफ़्लो के माध्यम से Cloud तैनाती को पुनः स्थापित करें। npm पैकेज को हटाने से पहले, स्थापित हुक और डेमन को हटाएं:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

संस्करण-विशिष्ट विवरण के लिए failproofai <command> --help चलाएं।

npm rm -g failproofai से पहले failproofai uninstall चलाएं; npm स्थापित एजेंट हुक या डेमन सेवा को नहीं हटाता है।

Connect your agents

Reference

एक मशीन सेट अप करें

कॉन्फ़िगरेशन फ़्लैग

नीति फ़्लैग

डिलीवरी और रखरखाव फ़्लैग

हार्नेस पाथ

पर्यावरण चर

एक मशीन को सुरक्षित रूप से पॉज़ या हटाएं

​एक मशीन सेट अप करें

​कॉन्फ़िगरेशन फ़्लैग

​नीति फ़्लैग

​डिलीवरी और रखरखाव फ़्लैग

​हार्नेस पाथ

​पर्यावरण चर

​एक मशीन को सुरक्षित रूप से पॉज़ या हटाएं

एक मशीन सेट अप करें

कॉन्फ़िगरेशन फ़्लैग

नीति फ़्लैग

डिलीवरी और रखरखाव फ़्लैग

हार्नेस पाथ

पर्यावरण चर

एक मशीन को सुरक्षित रूप से पॉज़ या हटाएं