Failproof AI CLI

התקן את ה-CLI המקומי עם npm install -g failproofai. הרץ אותו ללא ארגומנטים כדי לפתוח את לוח הבקרה של המדיניות המקומית. החבילה דורשת Node.js 20.9 ואילך. Bun 1.3 ואילך נתמך לפיתוח והתקנות מקוד. failproofai configure ו-failproofai setup הם כינויים ל-failproofai config; failproofai p הוא כינוי ל-failproofai policies.

הגדרת מכונה

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

הרץ את failproofai ללא ארגומנטים כדי לפתוח את לוח הבקרה של המדיניות המקומית.

פקודה	תוצאה
`failproofai config`	הרץ הגדרת מכונה אינטראקטיבית
`failproofai config --connect <url> --token <key>`	חבר הזרמת Cloud והעברת מדיניות
`failproofai config --status`	הצג מצב חיבור, daemon, העברה וקבוע השהייה
`failproofai policies`	רשום מדיניות מובנות, מותאמות אישית, קונוונציה, חבילה וממנוהלות על-ידי Cloud
`failproofai policies --install`	התקן hooks והפעל מדיניות
`failproofai policy add <name>`	הפעל מדיניות אחת — מובנית, או `<pack-id>:<name>` מחבילה מותקנת
`failproofai policy remove <name>`	השבת מדיניות אחת, אותה שמות
`failproofai policies --uninstall`	השבת מדיניות או הסר hooks של ה-harness
`failproofai pack list`	רשום חבילות מדיניות מותקנות וכל מדיניות שכל אחת נושאת
`failproofai pack add <source>`	התקן חבילת מדיניות מ-GitHub release; ללא tag לוקח את החדשה ביותר וקובע אותה
`failproofai pack add --bundled`	התקן את המדיניות המובנות כחבילה, מהחבילה זו, ללא רשת
`failproofai pack build <entry.mjs>`	בנה את שלושת נכסי ה-release לחבילה שלך
`failproofai pack remove <publisher/name>`	בטל הפעלה של חבילה מותקנת
`failproofai audit`	סרוק היסטוריית סוכנים מקומית ופתח את תצוגת הביקורת המקומית
`failproofai audit --schedule [days] --email <address>`	תזמן סריקות מקומיות חוזרות ושלח את הממצאים שלהן בדוא״ל
`failproofai audit --status`	הצג את כתובת הדוח, המרווח והסריקה הבאה המתוזמנת
`failproofai audit --no-schedule`	עצור סריקות חוזרות ללא מחיקת היסטוריית ביקורת
`failproofai harness list`	רשום נתיבי לכידה נוספים
`failproofai flush --wait`	העבר את ה-spool של האירוע הנוכחי
`failproofai backfill --since 30d`	קרא מחדש היסטוריה שעברה בעבר
`failproofai config --pause [duration]`	השהה ישומון מקומי אחד ל-30 דקות כברירת מחדל, עד 8 שעות
`failproofai config --resume`	התחזר לישומון מקומי המושהה; הוסף `--all` כדי לנקות את כל ההשהיות
`failproofai update`	סיים הידרות חבילה והדק את ה-daemon
`failproofai migrate --dry-run`	תצוג או הפעל הידרות פריסת ביתיות ממתינות
`failproofai uninstall`	הסר hooks וה-daemon לפני הסרת החבילה
`failproofai --version`	הדפס את גרסת החבילה המותקנת
`failproofai --help`	הצג פקודות ושימוש גלובלי

דגלי תצורה

דגל	שימוש
`--connect <url> --token <key>`	חבר בלא אינטראקטיבי
`--machine-id <id>`	הגדר את מזהה המכונה היציב
`--machine-label <name>`	הגדר או שנה את תווית לוח הבקרה
`--no-transcripts`	שלח החלטות ללא תוכן תמלול
`--disconnect`	עצור משיכות מדיניות Cloud והעברת אירוע
`--status`	הצג מצב מכונה נוכחי
`--pause [duration]`	השהה את הישומון החדש ביותר בספריה הנוכחית; מקבל שניות, דקות או שעות וברירת המחדל היא 30 דקות
`--resume`	סיים השהיה תואמת מוקדם
`--session <id>`	כוונן ישומון מפורש להשהיה או חזרה
`--all`	עם `--resume`, סיים כל השהיה פעילה

השהיות מקומיות משהות מדיניות מובנית, מותאמת אישית, קונוונציה וחבילה לישומון אחד. הם תמיד פוקעים ולא משביתים מדיניות ממנוהלות על-ידי Cloud. block-failproofai-commands — שהוא תמיד פעיל ולא ניתן להשבית או להשהות בעצמו — מונע מסוכן מכוונן לשימוש בדלת בריחה זו.

דגלי מדיניות

דגל	שימוש
`--install`, `-i`	הפעל מדיניות והתקן hooks של harness
`--uninstall`, `-u`	השבת מדיניות או הסר hooks
`--cli <names...>`	כוונן harness אחד או יותר הנתמכים
`--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; הוא מבצע הידרות פריסת ביתיות, מתקין את בינארי ה-daemon התואם, ומפעיל מחדש את השירות. --no-daemon מבצע רק את הידרת הפריסה.

נתיבי Harness

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

שמות harness הנתמכים הם claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity ו-goose. תוויות מרחב שמות מזהי סוכנים נגזרים כאשר שני roots מכילים עותקים של אותו פרויקט. roots חופפים וכינויים כפולים נדחים כדי למנוע אוספים כפולים או הישחתות cursor. תצורה של נתיבים נוספים טוענת מחדש ללא הפעלה מחדש של daemon. סביבות קונטיינר יכולות להחליף נתיבים קבועים בקובץ בעזרת משתנה מופרד בפסיקים בשם FAILPROOFAI_<HARNESS>_EXTRA_PATHS, למשל:

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

משתנים סביבתיים

השתמש בקובצי תצורה לתנהגות מכונה קבועה. משתנים סביבתיים שימושיים ביותר לקונטיינרים, בדיקות וכתיב אחד.

משתנה	שימוש
`FAILPROOFAI_HOME`	עביר את הפריסה השלמה של `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	הגדר מילולות רישום מקומיות
`FAILPROOFAI_HOOK_LOG_FILE`	כתוב אבחון hook לקובץ שנבחר
`FAILPROOFAI_TELEMETRY_DISABLED=1`	השבת טלמטריה אנונימית לתהליך זה
`FAILPROOFAI_NO_FIRST_RUN=1`	דלג על הגדרת ההפעלה הראשונה האינטראקטיבית
`FAILPROOFAI_NO_AUTO_AUDIT=1`	דלג על הביקורת המקומית לאחר ההגדרה
`FAILPROOFAI_LLM_BASE_URL`	דרוס את נקודת הקצה התואמת OpenAI המשמשת מדיניות LLM
`FAILPROOFAI_LLM_API_KEY`	סך את מפתח ה-API המשמש מדיניות LLM
`FAILPROOFAI_LLM_MODEL`	בחר את המודל המשמש מדיניות LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	חץ טעינת מודול מדיניות מותאם אישית
`FAILPROOFAI_NO_DOWNLOAD=1`	סרב להביא חבילות וביניאריות daemon; מה שמותקן שומר על אכיפה
`FAILPROOFAI_PACK_BASE_URL`	הביא חבילות ממראה במקום מ-`github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	החלף נתיבי לכידה נוספים מוגדרים לharness אחד
`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 כאשר ה-rollout עצמו הוא הבעיה. לפני הסרת חבילת npm, הסר hooks מותקנים וה-daemon:

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

הרץ את failproofai <command> --help לפרטים ספציפיים לגרסה.

הרץ את failproofai uninstall לפני npm rm -g failproofai; npm אינו מסיר hooks של סוכנים מותקנים או שירות daemon.

Connect your agents

Reference

הגדרת מכונה

דגלי תצורה

דגלי מדיניות

דגלי העברה ותחזוקה

נתיבי Harness

משתנים סביבתיים

השהה או הסר מכונה בבטחה

​הגדרת מכונה

​דגלי תצורה

​דגלי מדיניות

​דגלי העברה ותחזוקה

​נתיבי Harness

​משתנים סביבתיים

​השהה או הסר מכונה בבטחה

הגדרת מכונה

דגלי תצורה

דגלי מדיניות

דגלי העברה ותחזוקה

נתיבי Harness

משתנים סביבתיים

השהה או הסר מכונה בבטחה