> ## 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.

# أوامر Config

> المزوِّدون، والتكلفة، ولوحات المعلومات، والعلامة التجارية، والأطلس، والحزمة، وتكاملات MCP الاختيارية: config وcost وdash وbrand وatlas وstack وreport وtools وintegrations.

تُغطّي مجموعة Config المزوِّدين، والملاحظة، ورسم الشيفرة، واكتشاف الحزمة.

## `forge config`

إعداد المزوِّد — عرض / تبديل / إضافة المزوِّدين، وضبط النموذج الافتراضي.

```bash theme={null}
forge config               # show current config
forge config switch <provider>
forge config add <provider>
```

## `forge cost`

الإنفاق الفعلي في اليوم عبر معاملات المراحل المُقاسة.

```bash theme={null}
forge cost                 # real per-day spend
forge cost --stages        # measured per-stage cost factors
```

<Note>
  يُبلَّغ عن **المراحل المُقاسة فقط** — المرحلة التي لا أحداث فيها تقول "لا بيانات"،
  وليس قيمة افتراضية.
</Note>

## `forge dash`

لوحة معلومات محلية فوق السجل والقياسات ونصف قطر الانفجار.

```bash theme={null}
forge dash                 # localhost-only, read-only (default port 4242)
```

## `forge brand`

طباعة خريطة رموز العلامة التجارية الفعّالة.

```bash theme={null}
forge brand
```

تُخزَّن العلامة التجارية كرمز واحد (`brand.json`)؛ إعادة التسمية تعديل واحد فقط.

## `forge atlas`

بناء/استعلام رسم الشيفرة.

```bash theme={null}
forge atlas build [path]   # walk the tree → .forge/atlas.json
forge atlas query "what calls Z"
forge atlas has <symbol>   # hallucinated-symbol check
```

الأطلس JSON عادي — أي أداة تقرؤه، ولا حاجة إلى MCP.

## `forge stack`

اكتشاف حزمة المستودع الفعلية من ملفات البيانات الوصفية.

```bash theme={null}
forge stack
```

يقرأ `package.json`، و`pyproject.toml`، و`go.mod`، و`Cargo.toml`، و`Gemfile`،
و`composer.json`، و`pom.xml` / `build.gradle`، و`*.csproj`، ويُبلغ عن اللغات،
وأُطر العمل، ومديري الحِزم، وأوامر الاختبار **الفعلية** للمستودع — التي تُغذّي قائمة
تحقق الركيزة.

## `forge report` <sub>v0.19+</sub>

توليد تقرير HTML ثابت عن حالة Forge للمستودع — السجل والقياسات ونصف قطر الانفجار
مُصيَّرة في ملف مكتفٍ ذاتيًا يمكنك مشاركته أو أرشفته.

```bash theme={null}
forge report
```

## `forge tools` <sub>v0.19+</sub>

اختَر أداة الترميز الأساسية بالذكاء الاصطناعي لهذا المستودع، ووصِّل مدخلات `.gitignore`
المطابقة، ليتم تجاهل الإعدادات المُولَّدة وقطع `.forge/` تجاهلًا صحيحًا لإعدادك.

```bash theme={null}
forge tools
```

## `forge integrations`

خوادم MCP طرف ثالث اختيارية (على سبيل المثال `context7`)، تُدار بلا إتلاف عبر كل
أداة يُصدر Forge إعدادًا لها — Claude Code، وCodex، وCursor، وGemini، وContinue،
وبقيّة الأدوات.

خوادم MCP الطرف الثالث **غير** مثبّتة افتراضيًا. لا شيء يهبط على القرص إلى أن تُشغّل
`forge integrations add <name> --yes`.

```bash theme={null}
forge integrations                        # list opt-in servers with package + purpose
forge integrations add <name>             # dry-run: prints package, network, files it would touch
forge integrations add <name> --yes       # apply — write MCP config for every tool
forge integrations add <name> --yes --adopt   # also claim a same-name entry you already configured
forge integrations remove <name>          # reverse the add — deletes only forge-owned entries
```

### ماذا يكتب `add`

يكتب `add --yes` الخادمَ في إعداد MCP الأصلي لكل أداة من مواصفة قانونية واحدة:

* `.mcp.json` (Claude Code)
* `.cursor/mcp.json` (Cursor)
* `.gemini/settings.json` (Gemini)
* `.codex/config.toml` — ككتلة `# forge:managed:<name>`، تُحدَّث بمقارنة البايتات
* `.continue/mcpServers/<name>.yaml` — ملف YAML واحد مُعلَّم بعلامة forge لكل خادم مُدار
* وبقيّة الأدوات التي يُصدر Forge إعدادًا لها

تُسجَّل المجموعة المثبّتة في `.forge/forge.config.json` تحت `mcp.integrations`، فيُعيد
كلُّ `forge sync` لاحق إصدارَ الخوادم نفسها. تُقارن مزامنةُ خطّاف التوقف التلقائي
ملفَّ الإعداد كاملًا بالبايت، فيُكتشف أي تعديل يدوي على ذلك الملف ويُصلَح.

### دلالات `--adopt`

إذا كان هناك خادم بالاسم نفسه موجود سلفًا في أحد ملفات إعدادات الأدوات ولم يضعه
Forge هناك، فإن `add` **لا يستبدله**. بل يُبلّغ عن الملف مع تلميح `--adopt`.
أعِد التشغيل بـ `--adopt` للمطالبة بالملكية — يُسجّل Forge المدخل تحت
`mcp.adopted` في `.forge/forge.config.json` وسيُديره من ذلك الحين.

استخدم `--adopt` عندما تكون قد أعددت خادمًا يدويًا سابقًا وتريد الآن أن يُبقيه Forge
متزامنًا عبر كل الأدوات.

### `remove`

يعكس `forge integrations remove <name>` عمليةَ الإضافة. يحذف فقط المدخلات والكتل
والملفات المملوكة لـ forge — أما الخادم الذي يحمل الاسم نفسه وأعدّه المستخدم (ولم
يُطبَّق عليه `--adopt`) فيُترك كما هو. تشغيل `remove` مرّتين لا أثر له.

```bash theme={null}
forge integrations remove context7
```

### `.forge/forge.config.json`

حالة Forge لكل مستودع — الإعداد الموحّد الذي يحمل أيضًا `primaryTool` و`tools`
و`profile` — تُسجّل التكاملات الاختيارية تحت مفتاحين:

```json theme={null}
{
  "mcp": {
    "integrations": ["context7"],
    "adopted": []
  }
}
```

المفاتيح غير المعروفة تعبر الكتابات دون تغيير. لا يُتجاهل الملف المُعطوب بصمت:
تُصدر عمليات القراءة تحذيرًا واحدًا لكل عملية على stderr، ويرفض الكاتبون استبدال
إعداد لا يمكن تحليله بدلًا من الكتابة فوقه بالقيم الافتراضية.