मुख्य सामग्री पर जाएं
failproofai डैशबोर्ड आपके AI एजेंट सेशन की निगरानी और नीतियों के प्रबंधन के लिए एक स्थानीय वेब एप्लिकेशन है। देखें कि आपके एजेंट आपके न होने के दौरान क्या करते थे।

डैशबोर्ड शुरू करना

failproofai
http://localhost:8020 पर खुलता है। डैशबोर्ड सीधे फाइलसिस्टम से पढ़ता है - आपके Claude Code प्रोजेक्ट फोल्डर और failproofai कॉन्फ़िगरेशन फाइलें। कोई भी डेटा दूरस्थ सेवा में नहीं लिखा जाता है।

पृष्ठ

प्रोजेक्ट्स

आपकी मशीन पर मिले सभी Claude Code प्रोजेक्ट्स को सूचीबद्ध करता है। प्रोजेक्ट्स ~/.claude/projects/ से खोजे जाते हैं (या CLAUDE_PROJECTS_PATH द्वारा सेट किए गए पथ से)। प्रत्येक प्रोजेक्ट दिखाता है:
  • प्रोजेक्ट का नाम (फोल्डर पथ से व्युत्पन्न)
  • सेशन की संख्या
  • सबसे हाल की सेशन गतिविधि की तारीख
प्रोजेक्ट के सेशन देखने के लिए उस पर क्लिक करें।

सेशन्स

एक प्रोजेक्ट के भीतर सभी सेशन्स को सूचीबद्ध करता है। प्रत्येक सेशन दिखाता है:
  • सेशन ID
  • शुरुआत और समाप्ति समय
  • टूल कॉल की संख्या
  • हुक गतिविधि गणना (नीतियां जो सक्रिय हुईं)
सूची को कम करने के लिए दिनांक सीमा फ़िल्टर और सेशन ID खोज का उपयोग करें। सेशन्स पृष्ठांकित होते हैं। सेशन दर्शक खोलने के लिए एक सेशन पर क्लिक करें।

सेशन दर्शक

सेशन दर्शक स्वायत्त एजेंट के लिए मुख्य प्रश्न का उत्तर देता है: एजेंट ने क्या किया, और क्या वह सही रास्ते पर रहा? यह एक सेशन में हुई हर चीज की समयरेखा दिखाता है:
  • संदेश - Claude के पाठ प्रतिक्रियाएं और उपयोगकर्ता संकेत
  • टूल कॉल्स - हर टूल जो Claude ने आह्वान किया, इसके इनपुट और आउटपुट के साथ
  • नीति गतिविधि - प्रत्येक टूल कॉल के लिए, कौन सी नीतियां सक्रिय हुईं और उन्होंने कौन सा निर्णय लौटाया
शीर्ष पर सांख्यिकी पट्टी सेशन अवधि, कुल टूल कॉल्स, और हुक निर्णयों का सारांश (allow / deny / instruct गणना) दिखाती है। आप डाउनलोड बटन का उपयोग करके सेशन को ZIP या JSONL फाइल के रूप में निर्यात कर सकते हैं।

नीतियां

नीतियों के प्रबंधन और गतिविधि की समीक्षा के लिए एक दो-टैब पृष्ठ।
  • एक क्लिक के साथ व्यक्तिगत नीतियों को चालू या बंद करें (~/.failproofai/policies-config.json में लिखता है)
  • किसी नीति को उसके पैरामीटर को कॉन्फ़िगर करने के लिए विस्तृत करें (नीतियों के लिए जो policyParams का समर्थन करते हैं)
  • दिए गए स्कोप के लिए हुक्स को स्थापित या हटाएं
  • एक कस्टम नीतियां फाइल पथ सेट करें

ऑटो-रीफ्रेश

डैशबोर्ड के शीर्ष नेविगेशन में एक ऑटो-रीफ्रेश टॉगल है। जब सक्षम किया जाता है, तो वर्तमान पृष्ठ नई सेशन्स और नीति गतिविधि दिखाने के लिए समय-समय पर रीफ्रेश होता है। दीर्घकालीन स्वायत्त एजेंट सेशन्स की निगरानी के लिए आवश्यक है।

पृष्ठों को अक्षम करना

यदि आपको डैशबोर्ड के केवल कुछ हिस्सों की आवश्यकता है, तो FAILPROOFAI_DISABLE_PAGES को पृष्ठ नामों की अल्पविराम-सूची पर सेट करें:
FAILPROOFAI_DISABLE_PAGES=policies failproofai
मान्य मान: policies, projects.

थीम

डैशबोर्ड हल्के और गहरे मोड का समर्थन करता है। नेविगेशन बार में बटन के माध्यम से टॉगल करें। वरीयता आपके ब्राउज़र के स्थानीय भंडार में संग्रहीत होती है।

प्रोजेक्ट्स पथ को कॉन्फ़िगर करना

डिफ़ॉल्ट रूप से, डैशबोर्ड मानक Claude Code प्रोजेक्ट्स निर्देशिका से पढ़ता है। कस्टम सेटअप के लिए इसे ओवरराइड करें:
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

गैर-localhost होस्ट से पहुंचना

जब dev मोड में डैशबोर्ड चल रहा है (npm run dev) और आप इसे localhost के अलावा किसी होस्टनाम से एक्सेस कर रहे हैं - उदाहरण के लिए, एक कस्टम डोमेन, एक दूरस्थ IP, या एक सुरंगबद्ध URL - आप इस तरह एक चेतावनी देख सकते हैं:
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
यह Next.js अपने HMR (hot module reload) वेबसॉकेट के लिए क्रॉस-ऑरिजिन पहुंच को ब्लॉक कर रहा है, जो एक dev-only फीचर है। अपने होस्ट को अनुमति देने के लिए, --allowed-origins फ्लैग का उपयोग करें:
npm run dev -- --allowed-origins dashboard.example.com
कई होस्ट या IP के लिए, एक अल्पविराम-सूची पास करें:
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
आप इसके बजाय FAILPROOFAI_ALLOWED_DEV_ORIGINS पर्यावरण चर सेट कर सकते हैं:
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
यह केवल dev मोड पर लागू होता है। जब failproofai चल रहा है (production mode), कोई HMR वेबसॉकेट नहीं है और कोई क्रॉस-ऑरिजिन dev संसाधन समस्या नहीं है।