Failproof cli

title: “واجهة أوامر Failproof AI” description: “ثبّت الخطافات، أدِر السياسات المحلية، اتصل بالسحابة، وشغّل مراقب الخادم المحلي.” icon: “terminal”

ثبّت واجهة الأوامر المحلية باستخدام 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>`	اتصل بسحابة الاستقبال وتسليم السياسات
`failproofai config --status`	أظهر حالة الاتصال والمراقب والتسليم والإيقاف المؤقت
`failproofai policies`	اسرد السياسات المدمجة والمخصصة والاتفاقية والحزمة والمُدارة من السحابة
`failproofai policies --install`	ثبّت الخطافات وفعّل السياسات
`failproofai policy add <name>`	فعّل سياسة واحدة — مدمجة أو `<pack-id>:<name>` من حزمة مثبّتة
`failproofai policy remove <name>`	عطّل سياسة واحدة، نفس الأسماء
`failproofai policies --uninstall`	عطّل السياسات أو أزل خطافات الأجهزة
`failproofai pack list`	اسرد حزم السياسات المثبّتة وكل سياسة تحملها
`failproofai pack add <source>`	ثبّت حزمة سياسات من إصدار GitHub؛ عدم وجود وسم يأخذ الأحدث ويثبّته
`failproofai pack add --bundled`	ثبّت السياسات المدمجة كحزمة، من هذه الحزمة، بدون شبكة
`failproofai pack build <entry.mjs>`	أنشئ الأصول الثلاثة للإصدار لحزمة خاصة بك
`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`	اسلم ملف الأحداث الحالي
`failproofai backfill --since 30d`	أعد قراءة السجل المُمرر مسبقاً
`failproofai config --pause [duration]`	أوقف جلسة محلية واحدة مؤقتاً لمدة 30 دقيقة بشكل افتراضي، حتى 8 ساعات
`failproofai config --resume`	استئنف جلسة محلية موقوفة مؤقتاً؛ أضف `--all` لمسح جميع الإيقافات المؤقتة
`failproofai update`	أنهِ ترحيلات الحزمة وحدّث المراقب
`failproofai migrate --dry-run`	معاينة أو تشغيل ترحيلات تخطيط الصفحة الرئيسية المعلقة
`failproofai uninstall`	أزل الخطافات والمراقب قبل إزالة الحزمة
`failproofai --version`	اطبع إصدار الحزمة المثبّتة
`failproofai --help`	أظهر الأوامر والاستخدام العام

أعلام الإعدادات

العلم	الاستخدام
`--connect <url> --token <key>`	اتصل بشكل غير تفاعلي
`--machine-id <id>`	عيّن معرّف الجهاز الثابت
`--machine-label <name>`	عيّن أو غيّر تسمية لوحة التحكم
`--no-transcripts`	أرسل القرارات بدون محتوى النسخة
`--disconnect`	أوقف سحب سياسة السحابة وتسليم الأحداث
`--status`	أظهر حالة الجهاز الحالية
`--pause [duration]`	أوقف أحدث جلسة في الدليل الحالي مؤقتاً؛ يقبل الثواني أو الدقائق أو الساعات ويستخدم 30 دقيقة بشكل افتراضي
`--resume`	أنهِ إيقاف مطابق مبكراً
`--session <id>`	استهدِف جلسة صريحة للإيقاف المؤقت أو الاستئناف
`--all`	مع `--resume`، أنهِ كل إيقاف نشط

تعليق الجلسات المحلية يوقف السياسات المدمجة والمخصصة والاتفاقية والحزمة لجلسة واحدة. تنتهي دائماً ولا تعطّل السياسات المُدارة من السحابة. block-failproofai-commands — والتي تكون مفعّلة دائماً ولا يمكن تعطيلها أو إيقافها مؤقتاً بنفسها — تمنع وكيلاً مزوداً بأجهزة استشعار من استخدام هذا الثغرة بنفسها.

أعلام السياسات

العلم	الاستخدام
`--install`, `-i`	فعّل السياسات وثبّت خطافات الأجهزة
`--uninstall`, `-u`	عطّل السياسات أو أزل الخطافات
`--cli <names...>`	استهدِف جهاز أو أكثر من الأجهزة المدعومة
`--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؛ تقوم بإجراء ترحيلات تخطيط الصفحة الرئيسية وتثبيت ثنائي المراقب المطابق وإعادة تشغيل الخدمة. --no-daemon ينفذ فقط ترحيل التخطيط.

مسارات الأجهزة

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

أسماء الأجهزة المدعومة هي claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, وgoose. تضع التسميات مساحة أسماء معرّفات الوكيل المشتقة عند احتواء جذرين على نسخ من نفس المشروع. يتم رفض الجذور المتداخلة والتسميات المكررة لمنع الجمع المكرر أو فساد المؤشر. إعادة تحميل إعدادات المسارات الإضافية بدون إعادة تشغيل المراقب. يمكن لبيئات الحاويات استبدال المسارات الإضافية المكونة بملف بمتغير مفصول بفواصل يُسمى 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`	اكتب تشخيصات الخطافات إلى ملف محدد
`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`	رفض جلب الحزم والملفات الثنائية للمراقب؛ ما هو مثبّت يستمر في الإنفاذ
`FAILPROOFAI_PACK_BASE_URL`	جلب الحزم من مرآة بدلاً من `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	استبدل مسارات التقاط إضافية مكونة لجهاز واحد
`NO_COLOR`	عطّل مخرجات المحطة الملونة

متغيرات الصفحة الرئيسية الخاصة بالوكيل مثل CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME, وOPENCLAW_HOME تتجاوز حيث يكتشف Failproof AI جلسات محلية لذلك الجهاز.

إيقاف أو إزالة جهاز بأمان

failproofai config --pause
failproofai config --status
failproofai config --resume

لا يعطّل إيقاف الجلسة المحلية المؤقت السياسات المُدارة من السحابة. استعد نشرات السحابة من خلال سير عمل إنفاذ السحابة عند كون الطرح نفسه هو المشكلة. قبل إزالة حزمة npm، أزل الخطافات والمراقب المثبّتين:

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

شغّل failproofai <command> --help للحصول على تفاصيل خاصة بالإصدار.

شغّل failproofai uninstall قبل npm rm -g failproofai؛ npm لا يزيل خطافات الوكيل المثبّتة أو خدمة المراقب.

Connect your agents

Reference

title: “واجهة أوامر Failproof AI” description: “ثبّت الخطافات، أدِر السياسات المحلية، اتصل بالسحابة، وشغّل مراقب الخادم المحلي.” icon: “terminal”

إعداد جهاز

أعلام الإعدادات

أعلام السياسات

أعلام التسليم والصيانة

مسارات الأجهزة

متغيرات البيئة

إيقاف أو إزالة جهاز بأمان

​title: “واجهة أوامر Failproof AI” description: “ثبّت الخطافات، أدِر السياسات المحلية، اتصل بالسحابة، وشغّل مراقب الخادم المحلي.” icon: “terminal”

​إعداد جهاز

​أعلام الإعدادات

​أعلام السياسات

​أعلام التسليم والصيانة

​مسارات الأجهزة

​متغيرات البيئة

​إيقاف أو إزالة جهاز بأمان

title: “واجهة أوامر Failproof AI” description: “ثبّت الخطافات، أدِر السياسات المحلية، اتصل بالسحابة، وشغّل مراقب الخادم المحلي.” icon: “terminal”

إعداد جهاز

أعلام الإعدادات

أعلام السياسات

أعلام التسليم والصيانة

مسارات الأجهزة

متغيرات البيئة

إيقاف أو إزالة جهاز بأمان