Failproof AI CLI

ثبّت واجهة سطر الأوامر المحلية باستخدام npm install -g failproofai. قم بتشغيلها بدون معاملات لفتح لوحة معلومات السياسة المحلية. تتطلب الحزمة Node.js 20.9 أو أحدث. يتم دعم Bun 1.3 أو أحدث للتطوير والتثبيتات من المصدر. failproofai configure و failproofai setup هما اسمان مستعاران لـ failproofai config. failproofai policy و failproofai pack و failproofai p هي جميعاً تهجئات لـ failproofai policies — كانت الحزم والسياسات الفردية ثلاث أوامر لفكرة واحدة وهي الآن واحدة. التهجئات الأقدم لا تزال تعمل، مع استثناءين: pack list <source> أصبحت الآن policies show <source>، و pack build أصبحت الآن publish.

إعداد جهاز

ثبّت واجهة سطر الأوامر، ثم اقرأ مفتاح الجهاز في قذيفة النظام. read -s يأخذها عند مطالبة لا تصدر صدى، لذا لا تظهر أبداً في أمر:

npm install -g failproofai
read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

ثم أعد إعداد الجهاز واختر ما يفرضه:

failproofai config
failproofai policies add FailproofAI/policies
failproofai config --status

failproofai config هو كل الإعداد: يثبّت خدمة failproofaid (الجذر مرة واحدة، عبر sudo -n — لا يوجد أبداً مطالبة كلمة مرور تفاعلية)، ويربط الخطافات في كل واجهة سطر أوامر وكيل يجدها، ويتصل بـ Cloud عند توفر مفتاح. بدون terminal — CI، حاوية، وكيل يقودها — يطبق بدلاً من السؤال، ويخرج 1 إذا لم يحدث أي شيء طُلب منه القيام به. لا يختار أي سياسات. هذه هي وظيفة الأمر الثاني، وبدونها لا يفرض جهاز تم تكوينه حديثاً سوى الحارس الذي يعمل دائماً. فضّل متغير البيئة على --token: معامل سطر أوامر قابل للقراءة من ps بواسطة كل مستخدم على الصندوق. هذا كل ما يحميه المتغير — مفتاح يُكتب في أي أمر، بما في ذلك export، لا يزال ينتهي به الحال في سجل shell، ولهذا السبب يتم قراءته باستخدام read -s أعلاه. في CI، اضبطه من مخزن السرية واحتفظ بتتبع shell (set -x) مُيقِّفاً، أو سيطبع التتبع المفتاح.

--connect <url> يسجل جهاز تم إعداده بالفعل. يعود بمجرد نجاح التسجيل — لا يثبّت مستند الخدمة ولا يربط أي خطافات. استخدم failproofai config البسيط (أو failproofai config --token <key>) على جهاز لم يتم إعداده بعد، أو سيبدو كمتصل أثناء جمع وعدم فرض أي شيء.

قم بتشغيل failproofai بدون معاملات لفتح لوحة معلومات السياسة المحلية.

الأمر	النتيجة
`failproofai config`	إعداد الجهاز: الوكلاء، مستند الخدمة، وCloud عند وجود مفتاح
`failproofai config --token <key>`	الإعداد والاتصال في مرة واحدة، بدون السؤال عن أي شيء
`failproofai config --connect <url>`	تسجيل جهاز تم إعداده بالفعل — بدون مستند خدمة، بدون خطافات
`failproofai config --status`	عرض حالة الاتصال، مستند الخدمة، الإيصال، والتعليق
`failproofai policies`	قائمة السياسات المدمجة، المخصصة، الاتفاقية، الحزمة، والمدارة بواسطة Cloud
`failproofai policies --install`	ربط الخطافات في واجهات سطر أوامر الوكيل. لا يفعّل أي سياسة بمفردها
`failproofai policies add <name>`	تفعيل سياسة واحدة — مدمجة، أو `<pack-id>:<name>` من حزمة مثبتة
`failproofai policies remove <name>`	تعطيل سياسة واحدة، نفس التسمية
`failproofai policies --uninstall`	تعطيل السياسات أو إزالة خطافات الهيكل
`failproofai policies show <owner>/<repo>`	ما تحمله حزمة، المقروءة من بيانات التعريف الخاصة بها، قبل أخذها
`failproofai policies show <owner>/<repo> --releases`	كل إصدار نُشر، وأيها موجود هنا
`failproofai policies add <source>`	تثبيت حزمة سياسة من إصدار GitHub؛ بدون علامة تأخذ الأحدث وتثبتها
`failproofai publish`	شحن سياساتك الخاصة كحزمة؛ `--init` يكتب واحدة للبدء منها
`failproofai policies 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`	عرض الأوامر والاستخدام العام

أعلام التكوين

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

تعليقات الإيقاف المحلية تعلق السياسات المدمجة والمخصصة والاتفاقية والحزمة لجلسة واحدة. تنتهي دائماً ولا تعطّل سياسات Cloud المدارة. 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_CLOUD_TOKEN`	مفتاح Cloud، بدلاً من `--token`. فضّل هذا: معامل قابل للقراءة من `ps` بواسطة كل مستخدم. اضبطه باستخدام `read -s` أو من مخزن سرية CI، لا بطريقة كتابة المفتاح في أمر، الذي ينتهي به الحال في سجل shell في كلا الحالتين
`FAILPROOFAI_CLOUD_URL`	عنوان URL لـ Cloud، بدلاً من `--url`. نفس المتغير الذي يقرأه مستند الخدمة
`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

إيقاف جلسة محلية لا يعطّل سياسات Cloud المدارة. استعد نشرات Cloud من خلال سير عمل فرض Cloud عندما يكون الطرح نفسه هو المشكلة. قبل إزالة حزمة 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

إعداد جهاز

أعلام التكوين

أعلام السياسة

أعلام الإيصال والصيانة

مسارات الهيكل

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

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

​إعداد جهاز

​أعلام التكوين

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

​أعلام الإيصال والصيانة

​مسارات الهيكل

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

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

إعداد جهاز

أعلام التكوين

أعلام السياسة

أعلام الإيصال والصيانة

مسارات الهيكل

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

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