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

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

failproofai
נפתח בכתובת 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/ מתגלים כחזרות לאחור) עבור cwd סקלרי ב-meta.json / session.json / workspace.yaml; פרויקטי OpenCode מתגלים על ידי שאילתה של SQLite DB שלו ב-~/.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 (amber), Pi (ורוד), ו/או Gemini CLI (שמיים)
  • תאריך פעילות ההפעסה הנוכחית ביותר
לחץ על פרויקט כדי לראות את ההפעסות שלו.

הפעסות

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

צופה ההפעסה

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

ביקורת

דוח מונעי אישיות כיצד אייג’נט שלך בעצם התנהג על פני הפעסות קודמות. מריץ את אותה הסריקה כ-CLI של failproofai audit אך מוציא אותה כלוח בקרה בעל שש סעיפים:
  1. זהות — מסווג את אייג’נט שלך לאחד מ-8 ארכיטיפים (the optimist, the cowboy, the explorer, the goldfish, the paranoid architect, the precision builder, the hammer, the ghost) בהתאם לאילו גלאים + מדיניות הופעלה וכמה כבדה. מוציא סיגיל 8×8 פיקסל, את שורת תיוג הארכיטיפ, מסגרת “common in” / “primary risk”, וה-one-liner הסיום.
  2. הצג את אייג’נט שלך — תופס את כרטיס הזהות כ-PNG 1200×630 המתאים לפרסום לא X / LinkedIn (לחץ על make poster).
  3. חוזקות — התנהגויות משובצות ירוקות שאייג’נט שלך כבר עושה נכון, הנגזרות מנתוני הביקורת החיים (שיעור קריאות כלים נקי, אורך הפעסה ממוצע, אפס דלפי אישור, אפס סערות ניסיון חוזר וכו’).
  4. ניקוד + לוח דירוג — ניקוד 0–100 עם דרגה אות (S/A/B/C/D/F), היסטוגרמת התפלגות המראה היכן אתה נופל בקוהורטה, פרוזה (“a B starts at 71. you’re 13 points away.”), וטבלת לוח דירוג עם השורה שלך מודגשת.
  5. ממצאים — כרטיסי לפי ממצא דורגים לפי השפעה. כל כרטיס משטח מה קרה, מה זה עולה, דוגמה ראיות עם פקודות צולמות בפועל, והמדיניות failproofai שתתפוס את אותו דפוס ($ failproof policy add <slug>, click-to-copy).
  6. מדיניות שנקבעה + לולאת החזרה — רשת של כל מדיניות builtin שלא הופעלה שתסגור פער, עם callout ניקוד משוער, בתוספת “re-audit in 7 days” CTA.
מונעת על ידי זמן ריצת failproofai audit — ראה Audit CLI עבור מנוע הסריקה הבסיסי, דגלים נתמכים, וגם אי-ווריאנטים של מטמון לפי תמלול. לוח הבקרה קובע את התוצאה העדכנית ביותר ב-~/.failproofai/audit-dashboard.json (mode 0600, משבצת יחידה, ריצות חדשות דורסות) כך שביקורים חוזרים מיידיים; לחיצה על [ Re-run ↻ ] POSTs /api/audit/run ולוח הבקרה מתדלק /api/audit/status בתדירות 1Hz עד שהריצה מסתיימת. מצב ריק (אין מטמון) ומצב אפס-הפעסות (מטמון קיים אך הסריקה לא מצאה תמלולים) משטחים בנפרד.

מדיניות

עמוד בעל שני כרטיסיות לניהול מדיניות וביקורת פעילות.
  • בחר מרובה אילו אייג’נט CLIs failproofai מגן מפנל יחיד — 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 לרשימה מופרדת בפסיקים של שמות עמודים:
FAILPROOFAI_DISABLE_PAGES=policies failproofai
ערכים תקפים: policies, projects, audit.

קביעת נתיב הפרויקטים

כברירת מחדל, לוח הבקרה קורא מספרייה סטנדרטית של פרויקטי Claude Code. גבור עבור הגדרות מותאם אישית:
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

גישה מהוסט שאינו localhost

כאשר מריץ את לוח הבקרה ב-מצב dev (npm run dev) וגישה אליו מ-hostname שאינו 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 בלבד. כדי לאפשר את הוסט שלך, השתמש בדגל --allowed-origins:
npm run dev -- --allowed-origins dashboard.example.com
עבור מספר אתרים או IPs, עבור רשימה מופרדת בפסיקים:
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 (מצב ייצור), אין רשת HMR ואין בעיית משאב dev חוצה-אתר.