أوامر Config

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

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

​

forge config

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

forge config               # show current config
forge config switch <provider>
forge config add <provider>

​

forge cost

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

forge cost                 # real per-day spend
forge cost --stages        # measured per-stage cost factors

يُبلَّغ عن المراحل المُقاسة فقط — المرحلة التي لا أحداث فيها تقول “لا بيانات”، وليس قيمة افتراضية.

​

forge dash

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

forge dash                 # localhost-only, read-only (default port 4242)

​

forge brand

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

forge brand

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

​

forge atlas

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

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

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

forge stack

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

​

forge report _v0.19+

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

forge report

​

forge tools _v0.19+

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

forge tools

​

forge integrations

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

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

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 مرّتين لا أثر له.

forge integrations remove context7

​

.forge/forge.config.json

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

{
  "mcp": {
    "integrations": ["context7"],
    "adopted": []
  }
}

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