OpenRig: تنظيم Claude Code وCodex في فريق وكلاء عبر YAML

لمن هذا

OpenRig موجّه للمطورين الذين يريدون تنظيم عدة وكلاء برمجة في فريق ثابت: الـ rig يغلّف الـ harness الخاصة بك، وتُعرَّف فرقة الوكلاء في YAML، ثم يُقلَع بأمر واحد. أبرز قدراته تشغيل Claude Code وCodex معًا في الـ rig نفسه وإدارتهما كنظام واحد. قيمته في «الفريق»: بدلًا من الاعتناء بكل وكيل في نافذة طرفية منفصلة، اكتب الأعضاء في ملف YAML واحد ودَع أمرًا واحدًا وفحوص جاهزية موحدة تتولى الإدارة.

قبل البدء تحقّق من البيئة، ولا تُكمل قبل استيفاء البنود الأربعة: Node.js 22 أو 24 (22 على Apple silicon) وtmux وmacOS أو Linux (ويندوز عبر WSL2) وClaude Code أو Codex مسجّل الدخول. سُدّ أي نقص أولًا؛ فهذا وحده يوفّر عليك معظم الأخطاء اللاحقة. إن كنت لا تستخدم سوى وكلاء آخرين، أو تبقى على ويندوز الأصلي، أو تستخدم إصدار Node آخر، فالوثائق الرسمية لا تذكر دعم ذلك: اعتبره غير مؤكد.

وعلى العكس، ثلاث حالات يُستحسن التوقف عندها: من يتعامل بواجهة رسومية فقط ولا يريد كتابة إعدادات؛ ومن يحتاج التشغيل مباشرة على ويندوز الأصلي (دون WSL2)؛ ومن يريد عملاء غير Claude Code وCodex — فالشرح الرسمي لا يغطي هذه الاستخدامات. بعبارة أخرى: إن كنت عادةً تشغّل عميلًا واحدًا ولا تحتاج إقلاعًا موحدًا، فبنية الفريق في rig تجلب فائدة محدودة.

أول محاولة في 3 دقائق

المسار الرئيسي الموصى به واحد: ثبّت skill باسم rigs داخل Claude Code بالأمر الرسمي، بشرط جاهزية بيئة القسم السابق. شغّل في الطرفية:

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

الإصدار v0.7.0 في الأمر هو مسار إصدار ثابت ورد في الصفحة الرسمية، فانسخه كما هو. بعد اكتمال التثبيت، اكتب تعريف فريق الوكلاء في YAML؛ الترتيب هو: تثبيت الـ skill، كتابة YAML، التهيئة عند الحاجة (rig setup)، الإقلاع (rig up). الرسمي لا يقول أكثر من أن الفريق يُعرَّف في YAML ويُقلَع بأمر واحد، دون حقول أو أمثلة أو مواقع ملفات؛ تفاصيل الإعدادات تتبع ما يأتي مع الـ skill بعد التثبيت، فلا تكتبها بمجرّد التخمين.

ثم تأتي التهيئة. قبل تشغيل rig setup اعرف آثاره الجانبية: يضيف كتلة OpenRig إلى ~/.tmux.conf؛ وعلى macOS قد يثبّت tmux عبر Homebrew؛ وإن لم تمرّر --no-herdr فسيثبّت Herdr أيضًا. هذه هي نقطة التأكيد قبل التنفيذ — إن لم ترد Herdr فمرّر --no-herdr عند التشغيل.

أخيرًا الإقلاع: شغّل rig up؛ فيرفع جلسات tmux وكل harness وملفات بدء التشغيل ويجري فحوص الجاهزية. إشارات النجاح التي تراها: تظهر في tmux جلسات الفريق، ويعمل كل harness، وتعطي فحوص الجاهزية نتائج بندًا بندًا. إن لم تظهر جلسات أو فشل فحص، فعُد إلى قائمة البيئة وتحقق من إصدار Node وtmux. الرسمي لا يذكر هل يعدّل rig up ملفات أو يصل إلى الشبكة، وهذا غير مؤكد؛ وحتى هنا لم ينفّذ أي عضو عملًا حقيقيًا، فتأكد من سلامة الإقلاع قبل تكليفه بالعمل الفعلي.

حالات استخدام

الحالة الأولى: جعل Claude Code وCodex يتعاونان في الفريق نفسه. السياق: تستخدم العميلين معًا وتريدهما في نظام واحد مُدار. الطريقة: بعد تثبيت الـ skill rigs، عرّف الـ harness في YAML الفريق ثم شغّل rig up. النتيجة المتوقعة: يعمل الاثنان كنظام واحد، وتظهر لكل منهما جلسته في tmux، وتعطي فحوص الجاهزية نتائجها بندًا بندًا، ويبقى العضوان مرئيين في tmux بما يسهّل المقارنة.

الحالة الثانية: ضغط تحضير كل يوم في أمر واحد. السياق: لا تريد فتح tmux يدويًا ورفع الأعضاء واحدًا واحدًا كل مرة. الطريقة: بعد تعريف YAML الفريق، شغّل rig up عند بداية كل يوم ودعه يتولى جلسات tmux والـ harness وملفات بدء التشغيل وفحوص الجاهزية. النتيجة المتوقعة: يتقلص التحضير المتكرر إلى أمر واحد، وتخبرك نتيجة الفحوص مباشرة هل الفريق جاهز.

الحالتان تتسلسلان جيدًا: تأكد أولًا بالحالة الأولى من أن التشكيل نفسه ممكن، ثم اجعله مدخل اليوم الثابت كما في الحالة الثانية. كلتا الحالتين تتوقفان عند حدود الشرح الرسمي: كيفية تقاسم الأعضاء العمل بعد الإقلاع والمهام التي ينفذونها لا مثال رسمي لهما، ولا نختلق شيئًا هنا.

حدود الاستخدام

• البيئة والعملاء: الرسمي يسرد فقط Node.js 22 أو 24 (22 على Apple silicon) وtmux وmacOS/Linux (WSL2) وClaude Code أو Codex مسجّل الدخول؛ العملاء الآخرون وويندوز الأصلي وإصدارات Node الأخرى كلها غير مؤكدة.
• مساحة التثبيت والإصدار: التثبيت يتم عبر npx skills add، والأمر الرسمي مرتبط صراحة بـ --agent claude-code؛ لا سوق إضافات ولا طريقة مكافئة للعملاء الآخرين في الشرح الرسمي، فلا تستنتجها بنفسك. مسار التثبيت مثبّت على v0.7.0 وطريقة الترقية غير مذكورة.
• الآثار الجانبية ونقطة التأكيد: يضيف rig setup كتلة OpenRig إلى ~/.tmux.conf، وقد يثبّت tmux عبر Homebrew، ويثبّت Herdr إن لم تمرّر --no-herdr؛ تأكد قبل التنفيذ أنك تقبل هذه التغييرات.
• تعريف الفريق: حقول YAML المحددة والأمثلة ومواقع الملفات ليست في الشرح الرسمي، فلا تكتب الإعدادات بمجرّد التخمين.
• فحوص الجاهزية: ينفذها rig up، لكن بنودها الدقيقة وسلوكها عند الفشل غير مذكورين؛ اعتبر مخرَج الأمر هو المرجع ولا تفترض إعادة محاولة تلقائية ولا تراجعًا.
• سلوك المهام: OpenRig يتولى تنسيق الفرق؛ الشرح الرسمي لا يتناول إعادة كتابة النصوص أو تعديل ملفات المستخدم، وسلوك الأعضاء من ملفات وأوامر وشبكة أثناء التشغيل يتوقف على العميل الذي تختاره، ولا نضيف هنا حكمًا أمنيًا.
• بنود غير مؤكدة: الترخيص والتسعير وطريقة إزالة التثبيت وسلوك rig up عند الخروج والتنظيف والحد الأقصى لعدد الأعضاء في rig الواحد — لم يُعثر على أي منها في الشرح الرسمي.