> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# واجهة سطر الأوامر Failproof AI

> تثبيت الخطافات، إدارة السياسات المحلية، الاتصال بالسحابة، وتشغيل خادم الويب المحلي.

قم بتثبيت واجهة سطر الأوامر المحلية باستخدام `npm install -g failproofai`. قم بتشغيلها بدون وسائط لفتح لوحة التحكم للسياسات المحلية.

تتطلب الحزمة Node.js 20.9 أو الإصدار الأحدث. Bun 1.3 أو الإصدار الأحدث مدعوم للتطوير والتثبيتات من المصدر. `failproofai configure` و`failproofai setup` هي بدائل لـ `failproofai config`؛ `failproofai p` هي بديل لـ `failproofai policies`.

## إعداد الجهاز

```bash theme={null}
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>`                         | تفعيل سياسة مدمجة واحدة                                                   |
| `failproofai policy remove <name>`                      | تعطيل سياسة مدمجة واحدة                                                   |
| `failproofai policies --uninstall`                      | تعطيل السياسات أو إزالة خطافات الهيكل                                     |
| `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-self-pause` يمنع وكيل مزود من استخدام هذا الثغر بنفسه.

## علامات السياسة

| العلم                               | الاستخدام                                         |
| ----------------------------------- | ------------------------------------------------- |
| `--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` يقوم بترحيل التخطيط فقط.

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

```text theme={null}
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`، على سبيل المثال:

```bash theme={null}
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_<HARNESS>_EXTRA_PATHS`  | استبدال مسارات الالتقاط الإضافية المكونة لهيكل واحد         |
| `NO_COLOR`                           | تعطيل إخراج الطرفية الملون                                  |

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

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

```bash theme={null}
failproofai config --pause
failproofai config --status
failproofai config --resume
```

إيقاف جلسة محلية مؤقتاً لا يعطل سياسات السحابة المدارة. استعد نشرات السحابة من خلال سير عمل إنفاذ السحابة عندما تكون الطرح نفسه هو المشكلة.

قبل إزالة حزمة npm، أزل الخطافات المثبتة والخادم:

```bash theme={null}
failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai
```

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

<Warning>
  قم بتشغيل `failproofai uninstall` قبل `npm rm -g failproofai`؛ npm لا يزيل خطافات الوكيل المثبتة أو خدمة الخادم.
</Warning>