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

# واجهة Phaseo CLI

> ثبّت واجهة Phaseo CLI الرسمية، واضبط بيئات البرمجة، وأدر Phaseo من الطرفية.

تُوزّع Phaseo CLI ضمن الحزمة `@phaseo/cli`. وهي تربط بيئات البرمجة بـ Phaseo وتوفّر سير عمل رسميًا من الطرفية لإدارة مستوى التحكم في Phaseo.

استخدمها عندما تريد:

* تسجيل الدخول كمستخدم Phaseo من shell محلية أو بعيدة أو من بيئة وكيل
* إنشاء مفاتيح API أو مفاتيح الإدارة وتدويرها
* إدارة مساحات العمل والإعدادات المسبقة والضوابط والإعدادات
* استخدام OAuth الرسمي في CLI بينما تظل تطبيقات OAuth التي ينشئها المستخدمون قيد الاختبار الخاص
* استعراض النماذج والمزوّدين والأسعار والأرصدة والنشاط والتحليلات وعمليات الإنشاء

## التثبيت

<CodeGroup>
  ```bash title="npm" theme={null}
  npm install -g @phaseo/cli
  ```

  ```bash title="pnpm" theme={null}
  pnpm add -g @phaseo/cli
  ```

  ```bash title="yarn" theme={null}
  yarn global add @phaseo/cli
  ```

  ```bash title="bun" theme={null}
  bun add -g @phaseo/cli
  ```
</CodeGroup>

## التحقق من الإصدار المثبّت

```bash theme={null}
phaseo --version
phaseo version
phaseo version --json
```

* يعرض `phaseo --version` الإصدار المثبّت.
* يعرض `phaseo version` الإصدار وأمر التحديث الموصى به لمدير الحزم الحالي.
* تعرض عمليات التشغيل التفاعلية أيضًا تلميحًا بالتحديث عند توفر إصدار أحدث منشور.

يظل الأمر السابق `phaseo` متاحًا كاسم مستعار للتوافق.

## تسجيل الدخول

ابدأ باستخدام:

```bash theme={null}
phaseo login
```

تدعم CLI مسارين رسميين:

* **تسجيل الدخول باستخدام Phaseo**: OAuth عبر المتصفح باستخدام رمز التفويض وPKCE
* **تسجيل الدخول برمز الجهاز**: الأنسب لـ SSH وCI وبيئات shell غير التفاعلية والوكلاء

يمكنك فرض استخدام أي من المسارين:

```bash theme={null}
phaseo login --browser
phaseo login --device-code
```

تفضّل البيئات البعيدة وغير التفاعلية رمز الجهاز تلقائيًا.

## مخرجات الطرفية

تعرض الطرفيات التفاعلية ألوان Phaseo وتسلسله المرئي ومؤشرات إعداد مؤقتة. تستخدم المؤشرات `stderr` وتمسح سطرها عند اكتمال العمل. يعطّل `stderr` غير التفاعلي و`TERM=dumb` الحركة، بينما يعطّل `NO_COLOR` الألوان. تعيد الأوامر التي تستخدم `--json` دائمًا مخرجات منظّمة بلا زخرفة للوكلاء والأتمتة. استخدم `FORCE_COLOR=1` فقط عندما يدعم غلاف الطرفية الألوان لكنه لا يعرّف نفسه كـ TTY.

## تأكيد هويتك

```bash theme={null}
phaseo whoami
phaseo whoami --json
```

يعرض هذا المستخدم الحالي في Phaseo والنطاقات ومساحة العمل النشطة ومساحات العمل المتاحة.

## إنشاء المفاتيح

```bash theme={null}
phaseo keys create --name "Local CLI Key"
phaseo keys create --name "Agent Sandbox Key" --json
phaseo keys current
```

استخدم `--json` عندما يحتاج وكيل أو إجراء آلي إلى المفتاح المُنشأ بصيغته الخام لمرة واحدة.

## إدارة مساحات العمل والضوابط

```bash theme={null}
phaseo workspaces list
phaseo workspaces members <workspace-id-or-slug>

phaseo guardrails list
phaseo guardrails create --name "Production Safety" --body-json '{"enabled":true}'
```

تهدف CLI إلى إتاحة الوظائف المفيدة في لوحة Phaseo وواجهات الإدارة من الطرفية.

## تشغيل بيئات البرمجة المدعومة

تستخدم التكاملات الدائمة اسم المنتج مباشرةً:

```bash theme={null}
phaseo codex
phaseo claude-code
phaseo deepseek-harness
phaseo opencode
phaseo pi
phaseo prime-agent
phaseo openclaw
phaseo aider
phaseo roo-code
phaseo kilo-code
phaseo continue
phaseo cursor
phaseo zed
```

استخدم `--model` أو `--catalog all|default` أو `--dry-run` حسب الحاجة. يبقى الشكل القديم `phaseo integrations setup <integration>` متاحًا للتوافق، لكنه غير مطلوب.

تستطيع CLI تشغيل Cline وKilo Code وoh-my-pi وMuse Code وMiniMax Code بإعداد مزوّد مؤقت ومفتاح Phaseo مخصص. لكل بيئة دليل تكامل للإعداد وحل المشاكل: [Cline](./cline) و[Kilo Code](./kilo-code) و[oh-my-pi](./oh-my-pi) و[Muse Code](./muse-code) و[MiniMax Code](./minimax-code).

```bash theme={null}
phaseo cline --model openai/gpt-5.6-terra -- --tui
phaseo kilo --model openai/gpt-5.6-terra --
phaseo omp --model openai/gpt-5.6-terra --
phaseo muse --model meta/muse-spark-1.3 --
phaseo minimax --model openai/gpt-5.6-terra --
```

استخدم `phaseo run <cline|kilo|omp|muse|minimax>` للصيغة الصريحة. تأتي خيارات Phaseo قبل `--` وخيارات البيئة بعدها. استخدم `--catalog all` لمزامنة كل نماذج النص والدردشة النشطة في Phaseo، أو عاين دون إنشاء بيانات اعتماد باستخدام:

```bash theme={null}
phaseo cline --model openai/gpt-5.6-terra --dry-run --json
```

يُعرض تثبيت Cline وKilo Code وoh-my-pi تفاعليًا عند غيابها. يستخدم Muse Code وMiniMax Code مثبّتاتهما الرسمية عند غياب الأمر. على Windows يستخدم MiniMax Code مثبّت PowerShell الرسمي؛ استخدم `--skip-install` عند إدارة أي من البيئتين بشكل منفصل. لا تستبدل المشغّلات إعدادات Cline أوKilo أوoh-my-pi أوMuse Code أوMiniMax Code الموجودة.

## تطبيقات OAuth

يستخدم Phaseo خادم تفويض OAuth واحدًا لواجهة CLI الرسمية والتطبيقات التي ينشئها المستخدمون وعملاء MCP المسجّلين ديناميكيًا. تستخدم CLI تسجيل الدخول عبر المتصفح أو رمز الجهاز مع تدوير رموز التحديث. وتستخدم العملاء الخارجية رمز التفويض مع PKCE ونطاقات صريحة وموافقة مساحة العمل ورموز وصول مفوّضة قابلة للإلغاء وربطًا اختياريًا بمورد محمي.

تفعّل واجهة Phaseo API المستضافة OAuth للجهات الخارجية. وتبقيه عمليات النشر ذاتية الاستضافة أو التجريبية معطّلًا ما لم تُضبط `PHASEO_THIRD_PARTY_OAUTH_ENABLED` على قيمة صحيحة. القيم المقبولة هي `1` و`true` و`yes` و`on`، مع تجاهل حالة الأحرف بعد حذف المسافات. يؤدي التفعيل إلى إتاحة إدارة تطبيقات OAuth التي ينشئها المستخدمون والتسجيل الديناميكي للعملاء، لذا راجع إعدادات URI لإعادة التوجيه والموافقة وأسرار العملاء وحدود المعدل وتفويض مساحة العمل.

```bash title=".env" theme={null}
PHASEO_THIRD_PARTY_OAUTH_ENABLED=true
```

```bash title="Docker" theme={null}
docker run -e PHASEO_THIRD_PARTY_OAUTH_ENABLED=true phaseo
```

```yaml title="Kubernetes" theme={null}
env:
  - name: PHASEO_THIRD_PARTY_OAUTH_ENABLED
    value: "true"
```

## نموذج الأمان

تتطلب جلسات CLI افتراضيًا تخزينًا آمنًا يوفره نظام التشغيل. اضبط `PHASEO_SESSION_BACKEND=file` صراحةً فقط عند عدم توفر مخزن بيانات اعتماد للنظام؛ إذ يحفظ رموز التحديث في ملف نصي عادي بصلاحيات مقيّدة.

* يُبطل `phaseo logout` رمز التحديث المخزّن قبل مسح الحالة المحلية.
* تتطلب مفاتيح الإدارة إمكانات محددة صراحةً.
* تعتمد مفاتيح الاستدلال العادية على الضوابط وسياسات التوجيه وإعدادات مساحة العمل بدلًا من نموذج نطاقات منفصل.

## التحديث

<CodeGroup>
  ```bash title="npm" theme={null}
  npm install -g @phaseo/cli@latest
  ```

  ```bash title="pnpm" theme={null}
  pnpm add -g @phaseo/cli@latest
  ```

  ```bash title="yarn" theme={null}
  yarn global add @phaseo/cli@latest
  ```

  ```bash title="bun" theme={null}
  bun add -g @phaseo/cli@latest
  ```
</CodeGroup>

## الخطوات التالية

* [مفاتيح إدارة API](../../developers/management-api-keys.mdx)
* [المصادقة](../../developers/authentication.mdx)
* [Codex](./codex.mdx)
* [Claude Code](./claude-code.mdx)
* [Cline](./cline)
* [Kilo Code](./kilo-code)
* [oh-my-pi](./oh-my-pi)
* [Muse Code](./muse-code)
* [MiniMax Code](./minimax-code)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.