דלג לתוכן הראשי
לוח הבקרה של failproofai היא אפליקציית אינטרנט מקומית לעקיבה אחרי הפעלות סוכנים AI וניהול מדיניות. ראה מה עשו הסוכנים שלך כשלא היית.

​
הפעלת לוח הבקרה

failproofai
נפתח בכתובת http://localhost:8020. לוח הבקרה קורא ישירות מהמערכת הקבצים - תיקיות הפרויקט Claude Code שלך וקבצי התצורה של failproofai. שום דבר לא נכתב לשירות מרוחק.

​
דפים

​
Projects

מציג את כל פרויקטי 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/ כהפלה) עבור cwd סקלרי ב-meta.json / session.json / workspace.yaml; פרויקטי OpenCode מתגלים בשאילתה לבסיס הנתונים SQLite שלו ב-~/.local/share/opencode/opencode.db דרך opencode db --format json (אנחנו קוראים את טבלאות session ו-project וקיבוץ לפי project_id); פרויקטי Pi מתגלים בסריקת תמלולי JSONL לכל הפעלה תחת ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (ניתן להגדרה דרך PI_SESSIONS_DIR) וחילוץ ה-cwd מתיעוד הראשון של כל הפעלה; פרויקטי Gemini CLI מתגלים בסריקת ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl (ניתן להגדרה דרך GEMINI_SESSIONS_DIR) וחילוץ ה-cwd הקנוני מסימן הטקסט .project_root הסמוך. פרויקט ששימש בו כמה 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 (שמיים)
  • תאריך פעילות ההפעלה האחרונה
לחץ על פרויקט כדי לראות את ההפעלות שלו.

​
Sessions

מציג את כל ההפעלות בתוך פרויקט. כל הפעלה מציגה:
  • מזהה הפעלה
  • חותמות זמן התחלה וסיום
  • מספר קריאות לכלים
  • ספירת פעילות hook (מדיניות שהופעלו)
השתמש בסנן טווח התאריכים וחיפוש מזהה ההפעלה כדי לצמצם את הרשימה. ההפעלות מחולקות לעמודים. לחץ על הפעלה כדי לפתוח את מציג ההפעלה.

​
Session viewer

מציג ההפעלה עונה על השאלה העיקרית לסוכנים אוטונומיים: מה עשה הסוכן, והאם הוא נשאר במסלול? תג CLI לצד הכותרת מציין אם ההפעלה היא תמלול Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi או Gemini CLI. הוא מציג ציר זמן של כל מה שקרה בהפעלה:
  • Messages - תגובות הטקסט של Claude והנושאים של המשתמש
  • Tool calls - כל כלי שקרא Claude, עם קלט והוצאה שלו
  • Policy activity - לכל קריאה לכלי, איזו מדיניות הופעלה ומה החלטה היא החזירה
סרגל הנתונים בחלק העליון מציג משך ההפעלה, סך הכל קריאות לכלים וסיכום של החלטות hook (ספירת allow / deny / instruct). לחץ על כפתור Download Logs כדי לייצא את ההפעלה. לסוכנים Claude Code, Codex, Copilot, Cursor, Pi ו-Gemini אתה מקבל את תמלול JSONL המקורי על הדיסק בתמורה מדויקת; לעבור OpenCode (שההפעלות שלו חיות ב-SQLite, לא על הדיסק) אתה מקבל מסמך JSON המשקף את טבלאות session / messages / parts הבסיסיות.

​
Policies

דף בעל שתי כרטיסיות לניהול מדיניות וסקירת פעילות.
  • בחרו מסוכנים CLIs מרובים שהם failproofai מגן עליהם מלוח אחד — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ו-Gemini CLI כולם יש שורה עם סטטוס התקנה (Active / Detected / Inactive), נתיב הגדרות scope המשתמש והדגש צבוע מותג. סמן או בטל סימון של CLIs שאתה רוצה ולחץ Apply changes כדי להתקין/הסר התקנה את ההפרש בשלב אחד. CLIs שהקובץ הבינארי שלהם מתגלה ב-PATH מסומנים מראש.
  • החלף מדיניות בודדות בהפעלה וביטול בהפעלה אחת (כותב ל-~/.failproofai/policies-config.json — משותף לכל CLI מותקן)
  • הרחב מדיניות כדי להגדיר את הפרמטרים שלה (עבור מדיניות התומכת ב-policyParams)
  • הגדר נתיב קובץ מדיניות מותאם

​
Auto-refresh

לוח הבקרה כולל החלפה של auto-refresh בניווט העליון. כאשר מופעל, הדף הנוכחי מתרענן מעת לעת כדי להראות הפעלות חדשות ופעילות מדיניות כשהם מופיעים. חיוני לעקיבה אחר הפעלות סוכנים אוטונומיים ארוכי מועד.

​
השבתת דפים

אם אתה זקוק רק לחלקים מסוימים של לוח הבקרה, הגדר את 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) וגישה אליו מ-hostname אחר מ-localhost - לדוגמה, דומיין מותאם, IP מרוחק או כתובת URL tunneled - ייתכן שתראה אזהרה כמו: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
זה Next.js חוסם גישה cross-origin ל-HMR (hot module reload) שלו websocket, שהיא תכונה dev-only. כדי להרשות את ה-host שלך, השתמש בדגל --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 (מצב ייצור), אין websocket HMR ואין בעיית משאב dev cross-origin.