البدء السريع

هذا هو أقصر مسار من الصفر إلى تهيئة بيئة مُتحقَّق منها — تُثبِّت، وتُعرِّف ملف التعريف المشترك، وتحوِّل التهيئة الأصلية لأداة ما، وتؤكِّدها، ثم تجري أول تحرير لك. كل أمر حقيقي، وقابل للنسخ واللصق، وكل خطوة تُظهر ما يخرجه التشغيل النظيف. يكتمل التثبيت نفسه في أقل من دقيقتين، وتحرير ملف التعريف هو الجزء الوحيد الذي يستغرق ما تشاء من الوقت.

بنهاية ذلك ستملك تهيئة بيئة عاملة مُولَّدة من ملف تعريف كتبته بنفسك — وستعرف الأمر الوحيد الذي يدفع تغييرًا في ملف التعريف إلى كل أداة.

سنستخدم Claude Code مثالًا للبيئة — وهو الخيار الافتراضي للمثبِّت. غيِّر اسم المحوِّل في أي خطوة لتشير إلى أداة أخرى. تجد كل الأسماء المدعومة في قائمة البيئات.

1. ثبِّت Apothem

يُوزَّع Apothem بوصفه زمن تشغيل مكتفيًا ذاتيًا — يعمل المحرّك مباشرةً من شجرة شفرة مصدرية تدمج اعتماداتها. أمر واحد يُنزِّل الشفرة المصدرية، ويضع المحرّك، ويحوِّل أول بيئة.

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

يتطلّب المثبِّت Python 3.10+ يمكن من خلاله استيراد click وrich، وgit في الصيغة الشبكية. يفحص المتطلّبات المُسبقة، ويضع المحرّك في ~/.apothem، ويطبع عند الانتهاء استدعاء المحرّك الدقيق المناسب لصدفتك.

Apothem installed.
Run the engine with:

  apothem <command>

يتناول دليل التثبيت مسارات التثبيت الأخرى — إضافة Claude Code (/plugin marketplace add ahmed-g-gad/apothem يليه /plugin install apothem@apothem)، وملحقات عائلة VS Code وغيرها من الملحقات الأصلية للأدوات، وصيغة npx عند الطلب (npx @ahmed-g-gad/apothem <command>) — مع خيارات متغيرات البيئة.

2. أنشئ ملف التعريف المشترك

يكتب apothem profile init ملف تعريف صحيحًا بحدّه الأدنى في ~/.config/apothem/profile.yaml. مرِّر --profile PATH إن كنت تدير ملف تعريف خاصًا بمشروع أو بـ CI في مكان آخر.

apothem profile init
apothem profile show --json

يستخدم هذا الهيكل بيانات هوية وهمية بديلة، ومن الآمن تحريره قبل تثبيت أي مخرَج بيئة. أما show --json فيعيد قراءته ويُبلِغ عن ملف تعريف مُتحقَّق منه.

{
  "identity": {
    "name": "Example User",
    "email": "[email protected]",
    "github": "example-user"
  }
}

هنا أيضًا تظهر التحريرات غير الصحيحة. إن كان YAML غير صالح، يُبلِغ show عن ذلك في هذه اللحظة — قبل كتابة أي تهيئة بيئة. اجعل ملف التعريف ملكك عبر apothem profile edit (يفتحه في محرِّر)، أو اضبط مفتاحًا واحدًا في مكانه.

apothem profile set identity.name "Your Name"

3. ثبِّت محوِّلات البيئة

حوِّل محوِّل الأداة البرمجية التي تستخدمها بصورة أساسية. يقرأ هذا ملف تعريفك، ويكتب التهيئة الأصلية لتلك الأداة.

apothem install --harness claude-code

Installed claude-code.
Wrote: ~/.claude/settings.json

تتطلّب المحوِّلات ذات نطاق المشروع --project PATH، لأنها تكتب داخل المشروع لا في دليل المنزل. ولمعاينة أي تثبيت دون كتابة ملفات، استخدم --dry-run.

apothem install --harness cursor --project . --dry-run
apothem install --harness cursor --project .

ولتثبيت المجموعة الكاملة المدعومة بالسجلّ دفعةً واحدة، استخدم --harness all. يكتب هذا الاختيار ملفات بنطاق المشروع وبنطاق المستخدم معًا، لذا يعرض الأمر الوجهات المحدّدة مجمّعةً بحسب المكان، ويطلب التأكيد قبل الكتابة خارج جذر مشروعك.

apothem install --harness all --project .

تجد كل الأسماء المدعومة في القائمة الكاملة للبيئات، ومجموعة الخيارات الكاملة في مرجع install.

4. تحقَّق

التحويل نصف العمل فقط. يؤكِّد verify أن ملفات التهيئة المتوقَّعة للبيئة قد كُتبت وأنها تطابق ما يصرِّح به ملف التعريف.

apothem verify --harness claude-code

claude-code: managed targets verified.

يخرج verify برمز غير صفري إن كانت التهيئة مفقودة أو منحرفة، فيصلح بذلك بوّابةً في برامج الإعداد النصية. وللفحص الصحّي على مستوى الجهاز لكل محوِّل مُسجَّل، شغِّل:

apothem doctor

يُبلِغ doctor عن حالة تثبيت كل محوِّل، ويخرج برمز غير صفري إن أبلغ أي محوِّل مُسجَّل عن أنه غير مُثبَّت.

5. التشغيل الأول

افتح الأداة البرمجية التي أعددتَها للتوّ — Claude Code في هذا المثال — وابدأ جلسة في أي مشروع. القواعد والإعدادات التي كتبتها في ملف التعريف بالخطوة 2 صارت بالفعل جزءًا من سلوك تلك الأداة. ذلك هو تشغيلك الأول العامل — ملف تعريف واحد يصوغ جلسة حقيقية.

حين تُغيِّر ملف التعريف لاحقًا، أعد تطبيقه دون إعادة تثبيت.

apothem update --harness claude-code

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

• أضِف مزيدًا من البيئات — كرِّر الخطوة 3 لكل أداة.
• اكتب أول قاعدة — الوحدة التي ترثها كل البيئات.
• أنشئ خطة — مرِّر مهمّة كاملة عبر خط أنابيب التخطيط الحتمي.
• مرجع CLI — كل أمر، وخيار، ورمز خروج.