> ## Documentation Index
> Fetch the complete documentation index at: https://forgekit-docs-mintlify-9e781f1d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# التثبيت

> ثلاثة أبواب أمامية لشجرة واحدة: سوق الإضافات، وتثبيت npm العام، وتثبيت github: دون سجل — إضافةً إلى إعداد المساهمين بالروابط الرمزية.

يتّبع Forge تصميم **شجرة واحدة وثلاثة أبواب أمامية**: بيان المُلحق، والمُثبِّت المُقوّى،
وثنائي npm العام، جميعها تشير إلى الشجرة نفسها `global/` + `source/`. اختر القناة
الملائمة لأداتك.

## اختر قناة

<CardGroup cols={2}>
  <Card title="المُلحق (موصى به)" icon="puzzle-piece">
    لأداتَي Claude Code وCodex. تُوصَل الحواجز تلقائيًا؛ لا شيء يُدمج.
  </Card>

  <Card title="npm العام" icon="node-js">
    لأي أداة. واجهة سطر أوامر `forge` من سجل npm العام.
  </Card>

  <Card title="تثبيت github:" icon="github">
    لا حاجة إلى سجل — ثبّت مباشرة من المستودع.
  </Card>

  <Card title="مساهم / تطوير محلي" icon="code">
    استنساخ + `npm link`، أو `bash install.sh` لإعداد الروابط الرمزية.
  </Card>
</CardGroup>

## المتطلبات

* **Node.js >= 20**
* **صفر تبعيات وقت التشغيل** — كل شيء مبني داخل Node. الطبقات الاختيارية
  (تضمينات `FORGE_EMBED`، وPlaywright لأمر `uicheck visual`) اختيارية ولا تضيف أي
  تبعيات مطلوبة.

## سوق المُلحقات

المسار الموصى به لأداتَي Claude Code وCodex لا يحتاج رمزًا ولا استنساخًا:

```bash theme={null}
/plugin marketplace add CodeWithJuber/forgekit
/plugin install forgekit
```

يوصل المُلحق الحواجز عبر `${CLAUDE_PROJECT_DIR}` بحيث تعمل بوّابتا ما قبل الفعل والإكمال
بشكل ضمني.

## npm العام

لأي أداة، من npm العام:

```bash theme={null}
npm install -g @codewithjuber/forgekit
forge doctor          # everything green?
```

## تثبيت github: دون سجل

```bash theme={null}
npm install -g github:CodeWithJuber/forgekit
```

## مساهم / تطوير محلي

<CodeGroup>
  ```bash npm link theme={null}
  git clone https://github.com/CodeWithJuber/forgekit.git
  cd forgekit
  npm link
  ```

  ```bash install.sh (symlink setup) theme={null}
  git clone https://github.com/CodeWithJuber/forgekit.git
  cd forgekit
  bash install.sh
  ```
</CodeGroup>

المُثبِّت مُقوّى: عديم الأثر، ومبني على الروابط الرمزية، مع نسخة احتياطية، ودون
`curl | sh`.

## التحقّق

مهما كانت القناة التي استعملتها، تأكّد من التثبيت:

```bash theme={null}
forge doctor          # tools, guards, MCP auth, config drift, update status
```

<Note>
  يُظهر `forge doctor` أيضًا إشعارًا غير مُلحّ بشأن "التزامات متأخرة عن المنبع" لعمليات
  استنساخ git. اضبط `FORGE_NO_UPDATE_CHECK=1` لإسكاته. كل مسار يفشل بلطف — دون
  اتصال أو رأس منفصل يُبلَّغ عن "غير معروف"، لا خطأ.
</Note>

## إبقاء Forge محدَّثًا

```bash theme={null}
forge update --check          # report whether a newer version is available
forge update                  # apply the update (git checkout or npm/copy install)
forge update --to <version>   # pin or downgrade to a specific version
```

<Card title="والآن أعدّ المستودع" icon="arrow-right" href="/ar/quickstart">
  انتقل إلى البدء السريع لتشغيل `forge init` وأول فحص للركيزة.
</Card>