डैशबोर्ड शुरू करना
http://localhost:8020 पर खुलता है।
डैशबोर्ड सीधे फाइल सिस्टम से पढ़ता है - आपकी Claude Code प्रोजेक्ट फ़ोल्डर और failproofai कॉन्फ़िगरेशन फ़ाइलें। कोई भी डेटा किसी दूरस्थ सेवा को नहीं लिखा जाता है।
पृष्ठ
प्रोजेक्ट
आपकी मशीन पर पाए जाने वाले सभी Claude Code, OpenAI Codex, GitHub Copilot CLI (beta), Cursor Agent (beta), OpenCode (beta), Pi (beta), और Gemini CLI (beta) प्रोजेक्ट सूचीबद्ध करता है। Claude प्रोजेक्ट~/.claude/projects/ से खोजे जाते हैं (या CLAUDE_PROJECTS_PATH द्वारा सेट किए गए पथ); Codex प्रोजेक्ट ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl के तहत प्रत्येक ट्रांस्क्रिप्ट को स्कैन करके और प्रत्येक सेशन के पहले रिकॉर्ड में दर्ज cwd के आधार पर समूहीकृत करके खोजे जाते हैं; Copilot CLI प्रोजेक्ट ~/.copilot/session-state/<sessionId>/workspace.yaml को स्कैन करके (जो COPILOT_HOME के माध्यम से कॉन्फ़िगर किया जा सकता है) और इसके cwd फ़ील्ड के आधार पर समूहीकृत करके खोजे जाते हैं; Cursor Agent प्रोजेक्ट ~/.cursor/agent-sessions/<sessionId>/ के तहत प्रति-सेशन मेटाडेटा को स्कैन करके (जो CURSOR_HOME के माध्यम से कॉन्फ़िगर किया जा सकता है, जिसमें conversations/ और sessions/ फॉलबैक के रूप में जांचे जाते हैं) meta.json / session.json / workspace.yaml में cwd स्केलर के लिए खोजे जाते हैं; OpenCode प्रोजेक्ट ~/.local/share/opencode/opencode.db पर इसके SQLite DB को क्वेरी करके opencode db --format json के माध्यम से खोजे जाते हैं (हम session और project तालिकाओं को पढ़ते हैं और project_id के आधार पर समूहीकृत करते हैं); Pi प्रोजेक्ट ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl के तहत प्रति-सेशन JSONL ट्रांस्क्रिप्ट को स्कैन करके (जो PI_SESSIONS_DIR के माध्यम से कॉन्फ़िगर किया जा सकता है) और प्रत्येक सेशन के पहले रिकॉर्ड से cwd निकालकर खोजे जाते हैं; Gemini CLI प्रोजेक्ट ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl को स्कैन करके (जो GEMINI_SESSIONS_DIR के माध्यम से कॉन्फ़िगर किया जा सकता है) और भाई .project_root टेक्स्ट मार्कर से canonical cwd को पुनः प्राप्त करके खोजे जाते हैं। एक प्रोजेक्ट जो कई CLIs द्वारा उपयोग किया गया है, सभी मेल खाने वाले बैज के साथ एक एकल पंक्ति के रूप में प्रस्तुत होता है। तालिका के ऊपर CLI ड्रॉपडाउन का उपयोग करके एक विशिष्ट एजेंट CLI द्वारा फ़िल्टर करें; URL आपके चयन को ?cli=claude|codex|copilot|cursor|opencode|pi|gemini के रूप में संरक्षित करता है।
प्रत्येक प्रोजेक्ट दिखाता है:
- प्रोजेक्ट का नाम (फ़ोल्डर पथ से प्राप्त)
- एक CLI बैज —
Claude Code(नारंगी),OpenAI Codex(बैंगनी),GitHub Copilot(नीला),Cursor Agent(पन्ना),OpenCode(एम्बर),Pi(गुलाबी), और/याGemini CLI(आसमान) - सबसे हाल की सेशन गतिविधि की तारीख
सेशन
किसी प्रोजेक्ट के भीतर सभी सेशन सूचीबद्ध करता है। प्रत्येक सेशन दिखाता है:- सेशन आईडी
- शुरुआत और समाप्ति टाइमस्टैम्प
- टूल कॉल की संख्या
- हुक गतिविधि की संख्या (नीतियां जो निकाली गईं)
सेशन व्यूअर
सेशन व्यूअर स्वायत्त एजेंटों के लिए मुख्य प्रश्न का उत्तर देता है: एजेंट ने क्या किया, और क्या यह ट्रैक पर रहा? हेडर के बगल में एक CLI बैज यह इंगित करता है कि सेशन Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, या Gemini CLI ट्रांस्क्रिप्ट है। यह एक सेशन में हुई सभी चीजों की एक समयरेखा दिखाता है:- संदेश - Claude के पाठ प्रतिक्रियाएं और उपयोगकर्ता संकेत
- टूल कॉल - Claude द्वारा प्रत्येक टूल इनवोक किए गए, इसके इनपुट और आउटपुट के साथ
- नीति गतिविधि - प्रत्येक टूल कॉल के लिए, कौन सी नीतियां निकाली गईं और उन्होंने क्या निर्णय लौटाया
session / messages / parts तालिकाओं को प्रतिबिंबित करने वाला एक JSON दस्तावेज़ मिलता है।
नीतियां
नीतियों का प्रबंधन और गतिविधि की समीक्षा के लिए एक दो-टैब पृष्ठ।- नीतियां टैब
- गतिविधि टैब
- एक पैनल से failproofai किन एजेंट CLIs से सुरक्षित करता है, इसका चयन करें — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi, और Gemini CLI सभी के पास एक पंक्ति है जिसमें स्थापन स्थिति (
Active/Detected/Inactive), उपयोगकर्ता-स्कोप सेटिंग पथ, और एक ब्रांड-रंगीन एक्सेंट है। जिन CLIs को आप चाहते हैं उन्हें चेक या अनचेक करें और एक चरण में अंतर को स्थापित/अस्थापित करने के लिएApply changesपर क्लिक करें। जिन CLIs का बाइनरी PATH पर पहचाना जाता है वे पहले से चेक किए गए हैं। - एक क्लिक के साथ अलग-अलग नीतियों को चालू या बंद करें (
~/.failproofai/policies-config.jsonमें लिखता है — हर स्थापित CLI में साझा) - एक नीति को विस्तारित करें इसके पैरामीटर को कॉन्फ़िगर करने के लिए (उन नीतियों के लिए जो
policyParamsका समर्थन करती हैं) - एक कस्टम नीतियां फ़ाइल पथ सेट करें
स्वचालित ताज़ा करना
डैशबोर्ड में शीर्ष नेविगेशन में एक स्वचालित ताज़ा करना टॉगल है। सक्षम होने पर, वर्तमान पृष्ठ नई सेशन और नीति गतिविधि दिखाने के लिए समय-समय पर ताज़ा होता है। दीर्घ-चलने वाली स्वायत्त एजेंट सेशन की निगरानी के लिए आवश्यक।पृष्ठों को अक्षम करना
यदि आपको डैशबोर्ड के केवल कुछ हिस्सों की आवश्यकता है, तोFAILPROOFAI_DISABLE_PAGES को पृष्ठ नामों की अल्पविराम-पृथक सूची पर सेट करें:
policies, projects।
प्रोजेक्ट पथ कॉन्फ़िगर करना
डिफ़ॉल्ट रूप से, डैशबोर्ड मानक Claude Code प्रोजेक्ट निर्देशिका से पढ़ता है। कस्टम सेटअप के लिए इसे ओवरराइड करें:गैर-localhost होस्ट से पहुंचना
जब डैशबोर्ड को dev मोड (npm run dev) में चलाया जाता है और इसे localhost के अलावा किसी अन्य होस्टनाम से एक्सेस किया जाता है - उदाहरण के लिए, एक कस्टम डोमेन, एक दूरस्थ IP, या एक सुरंग वाली URL - आप यह चेतावनी देख सकते हैं:
--allowed-origins फ़्लैग का उपयोग करें:
FAILPROOFAI_ALLOWED_DEV_ORIGINS पर्यावरण चर को भी सेट कर सकते हैं:
यह केवल dev मोड पर लागू होता है। जब
failproofai को चलाया जाता है (production मोड), कोई HMR वेबसॉकेट नहीं होता है और कोई क्रॉस-ऑरिजिन dev संसाधन समस्या नहीं होती है।
