مدير git worktree
لـ Claude Code وCodex وكل أدوات CLI للوكلاء
علّم خانة واحدة في تذكرة، أو اختر worktree عند إضافة وكيل، فيعمل في الـ checkout الخاص به وعلى فرعه الخاص. يعدّل عدة وكلاء المستودع نفسه في الوقت نفسه دون أن يمسّ أحدهم ملفات الآخر.
قبل أن يبدأ الوكيل، يثبّت AgentsRoom التبعيات وينسخ ملفات .env لديك إلى الـ worktree الجديد، ليتمكن من البناء وتشغيل الاختبارات فورًا. وحين ينتهي، تراجع هذا الـ worktree وتنشئ له commit وتدفعه (push) وتدمجه من تبويب «التغييرات»، على سطح المكتب أو من هاتفك.
- وكيل الواجهة الخلفية.worktrees/fix-login-redirectمُجهَّز
- وكيل الواجهة الأمامية.worktrees/settings-dark-modeقيد العمل
- وكيل QA.worktrees/agents/qaمراجعة
ثلاثة وكلاء، ثلاثة worktrees، مستودع واحد: يُجهَّز كل checkout قبل أن يبدأ وكيله، ثم يُراجَع ويُدمج وحده.
وكيلان في الـ checkout نفسه هما شخصان يكتبان في الملف نفسه. أحدهما يشغّل أداة التنسيق بينما الآخر في منتصف تعديل، وأحدهما يبدّل الفرع من تحت قدمي الآخر، والـ diff الذي تراجعه في النهاية يخلط بين العملين. الـ git worktree يحل ذلك: checkout ثانٍ للمستودع نفسه، في مجلده الخاص وعلى فرعه الخاص، يشارك السجل لكن لا يشارك الملفات.
إنشاء واحد منها يتطلب أمر git واحدًا. أما العيش مع عشرة منها فهو الجزء الصعب: الـ worktree الجديد لا يحتوي على node_modules ولا على .env، فيفشل أول build للوكيل؛ ولا شيء يخبرك أي وكيل يعمل أين؛ وحين ينتهي العمل لا يزال عليك أن تجد المجلد وتراجعه وتنشئ له commit وتدمجه.
يتولى AgentsRoom دورة الحياة هذه. تطلب تذكرة في قائمة المهام أو يطلب وكيل worktree، فينشئه AgentsRoom من فرع أساس محدَّث داخل المشروع تحت .worktrees/، ويجهّزه، ويشغّل الوكيل فيه، ويمنحك محددًا في تبويب «التغييرات» لمراجعته وإنشاء commit له ودفعه ودمجه. ويعمل بالطريقة نفسها أيًّا كانت أداة CLI التي تشغّل الوكيل: Claude وCodex وGitHub Copilot CLI وCursor و10 أدوات CLI أخرى للوكلاء.
تبقى الـ worktrees اختيارية. الوكيل الذي لا worktree له يواصل العمل في مجلد المشروع كما من قبل، وأنت تقرّر لكل تذكرة أو لكل وكيل أو لكل قالب وكيل.
ما يفعله مدير الـ worktrees
من اللحظة التي تطلب فيها مهمة checkout معزولًا إلى اللحظة التي يُدمج فيها فرعها.
worktree واحد لكل تذكرة في قائمة المهام
علّم «العمل في شجرة عمل منفصلة لهذه المهمة» في تذكرة، واختر أحد worktrees المشروع أو اكتب اسم فرع جديد، فيُنشئ بدء التذكرة الـ worktree ويشغّل الوكيل داخله.
اختر worktree عند إضافة وكيل
تعرض بطاقة «مساحة العمل» في نافذة «إضافة وكيل» خيار «الرئيسية» وworktrees المشروع الموجودة و«جديدة». والـ worktree الذي أنشأته بنفسك باستخدام git worktree add يظهر في القائمة أيضًا.
worktree جديد لكل وكيل من قالب
فعّل «worktree جديد لكل وكيل» في وكيل محفوظ أو في ملف افتراضي، فيحصل كل وكيل يُشغَّل منه على فرعه الخاص، باسم agents/<قالب> ثم -2 و-3، فلا تتشارك النسخ checkout واحدًا أبدًا.
جاهز للبناء من أول تشغيل
قبل أن يبدأ أول وكيل في worktree جديد، ينسخ AgentsRoom الملفات التي يتجاهلها git ويحتاجها الوكيل (كل ملفات .env افتراضيًا) ويشغّل أمر التثبيت المكتشف من ملف القفل (lockfile) لديك: yarn أو pnpm أو npm أو bun أو uv أو poetry أو pipenv أو bundle أو composer.
راجع كل worktree وأنشئ له commit وادفعه
محدد «شجرة العمل» أعلى تبويب «التغييرات» يحوّل الـ diff والمراجعة و«إيداع» و«سحب» و«دفع» إلى هذا الـ checkout. والنقر على شارة وكيل له worktree خاص به يفتحه مباشرة.
يُدمج عند اكتمال التذكرة
مع «الدمج التلقائي في الفرع الحالي عند اكتمال المهمة»، يؤدي نقل التذكرة إلى «مكتمل» إلى دمج فرعها. فعّل «إنشاء commit تلقائيًا عند انتهاء العمل» ليدخل في الدمج ما تركه الوكيل دون commit.
كيف يعمل
مسار تذكرة واحدة، من النموذج إلى الدمج.
- 1
اطلب worktree في التذكرة
في نموذج التذكرة، تحت «التنفيذ»، علّم «العمل في شجرة عمل منفصلة لهذه المهمة». اختر worktree موجودًا من الشارات، أو أبقِ حقل «اسم الفرع»: يُملأ مسبقًا من العنوان ما لم تعدّله، ويصبح worktree جديدًا عند بدء المهمة.
- 2
ابدأ التذكرة
يجلب AgentsRoom فرع الأساس (الفرع الافتراضي في المستودع البعيد، أو «فرع الأساس لأشجار العمل» المضبوط في إعدادات المشروع)، وينشئ الـ worktree تحت .worktrees/<فرع>/ ويضيف هذا المجلد إلى ملف .git/info/exclude في النسخة المستنسخة، فلا يظهر أبدًا كملفات غير متتبَّعة في الـ checkout الرئيسي لديك.
- 3
يُجهَّز الـ worktree، ثم يبدأ الوكيل
تعرض طرفية الوكيل أمر التثبيت ومخرجاته، ويخبرك إشعار بعدد الملفات المتجاهَلة التي نُسخت، ثم تبدأ أداة CLI الخاصة بالوكيل في الـ worktree. يحدث هذا مرة واحدة لكل worktree؛ والتثبيت الفاشل لا يوقف الوكيل أبدًا، ويبقى الخطأ في طرفيته.
- 4
راجع وادمج
اختر الـ worktree في تبويب «التغييرات» لقراءة الـ diff وإنشاء commit. انقل التذكرة إلى «مكتمل»، ومع تفعيل الدمج التلقائي يُدمج فرعها في الفرع الحالي؛ ويعرض التأكيد النتيجة. أما الـ worktree نفسه فيبقى على القرص لنظرة أخيرة.
Claude Code وCodex ينشئان worktrees بالفعل. إليك الفرق.
لدى Claude Code خيار خاص به: claude --worktree feature-auth ينشئ .claude/worktrees/feature-auth على فرع اسمه worktree-feature-auth، وينسخ الملفات التي يتجاهلها git والمدرجة في ملف .worktreeinclude، ويسألك عند الخروج هل تبقي الـ worktree أم تحذفه. وتقول وثائقه صراحة إن الـ worktree هو checkout جديد، وإن عليك تثبيت التبعيات بنفسك أو أن تطلب ذلك من Claude. ويمكن أيضًا أن يحصل كل وكيل فرعي على worktree خاص به باستخدام isolation: worktree.
يدير تطبيق Codex الـ worktrees في $CODEX_HOME/worktrees، ويبدؤها بوضع HEAD منفصل من الفرع الذي اخترته، ويقرأ هو أيضًا .worktreeinclude، ويشغّل سكربتات الإعداد لبيئة محلية إن اخترت واحدة، ويحتفظ افتراضيًا بأحدث 15 منها. وتنقل Handoff محادثة وشيفرتها بين Local وworktree. ولدى codex-cli 0.162.1 خيار --worktree أيضًا.
كلاهما جيد، وكل منهما يتبع مزوّدًا واحدًا. لا يحل AgentsRoom محلهما: بل يضع العزل نفسه في مستوى أعلى، حيث توجد تذاكرك ووكلاؤك، لكل أدوات CLI دفعة واحدة، ويجهّز الـ checkout قبل أن يراه الوكيل، ويُبقي المراجعة والـ commit والدمج في النافذة التي تستخدمها أصلًا. تم التحقق على Claude Code 2.1.299 وcodex-cli 0.162.1، أكتوبر 2026.
ما يجب معرفته
- لا يُحذف أي worktree تلقائيًا، وذلك عن قصد، حتى تتمكن من مراجعته. لذا تتراكم تحت .worktrees/؛ احذف واحدًا منها باستخدام git worktree remove حين تنتهي منه، ولا تفعل ذلك أبدًا ووكيل لا يزال يعمل داخله.
- الدمج التلقائي الذي يصطدم بتعارض يسجّل تحذيرًا وتنتقل التذكرة رغم ذلك إلى «مكتمل»: احسم هذا الدمج يدويًا.
- تحتاج الـ worktrees إلى مستودع git في جذر المشروع. المجلد الذي يكتفي بجمع عدة مستودعات جنبًا إلى جنب لا يحصل على أي worktree: افتح كل مستودع كمشروع مستقل.
- المشروع المفتوح على خادم SSH تكون worktrees الخاصة به على الخادم، دون خطوة التثبيت. أما الـ checkout المحلي الذي يعمل وكلاؤه على جهاز بعيد فلا يمكنه استخدام الـ worktrees، وتقول التذكرة ذلك بدل أن تبدأ.
- لا يحصل وكيل QA أبدًا على worktree خاص به: فهو يختبر داخل الـ checkout الخاص بوكيله الرئيسي، لأن worktree جديدًا لن يحتوي على العمل الذي لم يُنشأ له commit بعد والذي عليه اختباره.
الأسئلة الشائعة
ما هو الـ git worktree، ولماذا نعطي واحدًا لوكيل ذكاء اصطناعي؟
الـ git worktree هو checkout ثانٍ للمستودع نفسه، في مجلده الخاص وعلى فرعه الخاص، يشارك السجل والمستودع البعيد مع الـ checkout الرئيسي لديك. إعطاء واحد لكل وكيل برمجة بالذكاء الاصطناعي يعني أن كل وكيل يعدّل نسخته الخاصة من الملفات ويبنيها وينشئ لها commit، فلا يكتب وكيلان يعملان في الوقت نفسه فوق عمل بعضهما أبدًا، ولا يبدّل أحدهما الفرع من تحت قدمي الآخر. في مدونتنا دليل أطول عن جانب git: أشجار عمل Git (git worktrees): الأساس لتشغيل عدة وكلاء ذكاء اصطناعي دون تعارضات.
هل يحتوي Claude Code على worktrees مدمجة؟
نعم. claude --worktree <اسم> (أو -w) ينشئ .claude/worktrees/<اسم> على فرع اسمه worktree-<اسم>، وينسخ الملفات التي يتجاهلها git والمدرجة في .worktreeinclude، ويسألك عند الخروج هل تبقي الـ worktree أم تحذفه؛ ويمكن للوكلاء الفرعيين العمل في worktree خاص بهم باستخدام isolation: worktree. لكنه لا يثبّت تبعياتك. في AgentsRoom يمكنك مواصلة استخدامه، أو ترك التذكرة أو الوكيل يطلب الـ worktree، وهذا يجهّزه أيضًا ويعرضه في تبويب «التغييرات» (تم التحقق على Claude Code 2.1.299).
هل يدعم Codex الـ worktrees؟
تطبيق Codex يدعمها: فهو ينشئ worktrees مُدارة في $CODEX_HOME/worktrees، بوضع HEAD منفصل، وينسخ الملفات المتجاهَلة المدرجة في .worktreeinclude، ويمكنه تشغيل سكربتات الإعداد لبيئة محلية، ويحتفظ بأحدث 15 منها، وينقل محادثة بين Local وworktree باستخدام Handoff. ولدى codex-cli 0.162.1 خيار --worktree يشغّل جلسة في worktree مُدار جديد. يعطي AgentsRoom وكيل Codex الـ worktree بالطريقة نفسها التي يعطيه بها لأي وكيل آخر، من التذكرة أو من نافذة «إضافة وكيل».
ما أدوات CLI للوكلاء التي يمكن تشغيلها في worktree من AgentsRoom؟
كلها: الـ worktree ببساطة هو مجلد عمل الوكيل، أيًّا كانت أداة CLI التي تعمل فيه، لذا تعمل فيه Claude وCodex وGitHub Copilot CLI وCursor و10 أدوات CLI أخرى للوكلاء بالطريقة نفسها. تثق Kimi Code وAntigravity CLI بمجلد من خلال مساره الدقيق؛ فيسجّل AgentsRoom الـ worktree الجديد كمجلد موثوق لديهما قبل التشغيل، حتى لا تتوقفا عند سؤال الثقة.
هل عليّ تشغيل yarn install ونسخ ملف .env إلى كل worktree؟
لا. قبل أن يبدأ أول وكيل في worktree جديد، ينسخ AgentsRoom ملفات الـ checkout الرئيسي التي يتجاهلها git والمطابقة لـ «الملفات المنسوخة من هذه النسخة» (كل ملفات .env افتراضيًا) ويشغّل أمر التثبيت المكتشف من ملف القفل (lockfile) في الجذر. يُضبط الاثنان في إعدادات المشروع > Git > تجهيز أشجار العمل الجديدة، حيث يمكنك استبدال الأمر، مثلًا pnpm install && pnpm build:deps. والملف الموجود أصلًا في الـ worktree لا يُستبدل أبدًا.
كيف أراجع ما فعله وكيل في الـ worktree الخاص به وأدمجه؟
افتح تبويب «التغييرات» واختر الـ worktree في محدد «شجرة العمل» في الأعلى: عندها تعمل قائمة الملفات والـ diffs والمراجعة و«إيداع» و«سحب» و«دفع» على هذا الـ checkout. وبالنسبة للتذكرة، يدمج خيار «الدمج التلقائي في الفرع الحالي عند اكتمال المهمة» فرعها حين تنقلها إلى «مكتمل»، ويُنشئ خيار «إنشاء commit تلقائيًا عند انتهاء العمل» (الإعدادات > Backlog) أولًا commit لما تركه الوكيل، فيحمل الدمج العمل كله.
أين توجد الـ worktrees، وهل تُنظَّف؟
داخل المشروع، تحت .worktrees/<فرع>/، وتُنشأ من الفرع الافتراضي في المستودع البعيد ما لم تضبط «فرع الأساس لأشجار العمل» في إعدادات المشروع. يُضاف المجلد إلى ملف .git/info/exclude في النسخة المستنسخة، ولا يُضاف أبدًا إلى ملف .gitignore لديك، فيبقى خارج commits الخاصة بك. لا تُحذف الـ worktrees تلقائيًا أبدًا: احذف واحدًا منها باستخدام git worktree remove حين تنتهي منه.
هل يمكنني استخدام الـ worktrees من هاتفي أو على خادم بعيد؟
نعم في الحالتين. على الهاتف، تحتوي شاشة «التغييرات» على محدد «شجرة العمل» نفسه، والتذكرة التي تطلب worktree تعمل فيه حين تبدؤها من الهاتف، ويجهّزه سطح المكتب كأي worktree آخر. والمشروع المفتوح على خادم SSH تكون worktrees الخاصة به على الخادم، دون خطوة التثبيت. أما الـ checkout المحلي الذي يعمل وكلاؤه على جهاز بعيد فلا يمكنه استخدام الـ worktrees، وتخبرك التذكرة بذلك بدل أن تبدأ.
قراءات إضافية
أشجار عمل Git (git worktrees): الأساس لتشغيل عدة وكلاء ذكاء اصطناعي دون تعارضات
وكلاؤك يكتبون فوق بعضهم البعض عندما يعملون بالتوازي. أشجار عمل git تحل المشكلة بأمرين فقط. إليك طريقة استخدامها.
عشرة وكلاء شغّلوا نفس فحص الأنواع في اللحظة نفسها. الحل كان مجلدًا.
سبعة عشر وكيل برمجة في نفس النسخة من المستودع، عشر عمليات tsc في وقت واحد، load average عند 37 و87 ميغابايت من الذاكرة الحرة. فحص أنواع مدته تسعون ثانية استغرق 7 دقائق و36 ثانية. إليك القياس، وسبب أن الآلة لم تكن تحسب، والقفل المشترك الصغير الذي حل المشكلة. قابل للنسخ إلى أي مستودع.
كيفية تشغيل 3 إلى 8 وكلاء ترميز بالتوازي دون فقدان المسار
إطلاق عدة وكلاء Claude Code أو Codex في وقت واحد سهل. الحفاظ على السيطرة هو المكان الذي ينهار فيه الأمر. إليك الطريقة التي تعمل بالفعل.
قد يعجبك أيضًا
إدارة المهام
لوحة كانبان بصرية لتنسيق وكلاء الذكاء الاصطناعي بالسحب والإفلات. أنشئ مهاماً في TODO، اسحبها إلى In Progress لإطلاق وكيل Claude تلقائياً، وتابع الإنجاز عبر عمودي Pending وDone. تطوير مدفوع بالسجل للبرمجة المتوازية بالذكاء الاصطناعي.
مراجعة لكل وكيل
راجع تغييرات الكود من كل وكيل ذكاء اصطناعي على حدة. AgentsRoom يتتبع أي وكيل Claude Code عدّل أي ملفات. فلتر الفروقات حسب الوكيل، راجع فردياً، واحفظ لكل وكيل لتاريخ git نظيف.
متعدد المشاريع · متعدد الوكلاء · بالتوازي
يشغّل AgentsRoom عدة وكلاء ذكاء اصطناعي من Claude وCodex وGitHub Copilot CLI وCursor و10 أدوات CLI أخرى للوكلاء بالتوازي عبر عدة مشاريع، كلها في نافذة واحدة. أدوار مرمّزة بالألوان، حالة حية، عدّادات لكل مشروع، إشعارات أصلية على سطح المكتب والجوال. البديل البصري لاثني عشر تبويباً طرفياً وفوضى جلسات Claude Code المبعثرة عبر iTerm2 وWarp وtmux.
تخصيص الوكلاء
اختر من بين 14 دور وكيل مدمج، أضف وكلاء متخصصين من The Agency، أو قم ببناء وكيل برمجة ذكاء اصطناعي مخصص خاص بك مع موجه النظام الخاص به. ثم شارك وكلائك مع فريقك من خلال الدردشة، وانشرهم في المجتمع حتى يتقدم الجميع معًا.
Multi-Agent Workflow • Handoff • Feedback Loop
يربط AgentsRoom Agent Teams وكلاء البرمجة بالذكاء الاصطناعي كفريق هندسي حقيقي. محرر مرئي لسير العمل (لوحة بأسلوب n8n) لتوصيل أدوار Dev و QA و PM و Security و DevOps. تسليم تلقائي مع ملخص و git diff ومخاطر وتلميحات اختبار. بوابات جودة يتحقق منها الجهاز (مجموعة اختباراتك هي من تقرر، لا الوكيل)، وفروع مراجعة QA و Security متوازية، وروابط شرطية، وحلقات تغذية راجعة، وحد أقصى للدورات. اختر لكل فريق كيف تعمل الأدوار : وكيل واحد يتحوّل من دور إلى آخر ويحتفظ بالسياق كله، أو وكيل حيّ لكل دور يتراسلون في الوقت الحقيقي. منسق الوكلاء المتعددين الذي كان ينقص وكلاء Claude و Codex و GitHub Copilot CLI و Cursor و 10 أدوات CLI أخرى للوكلاء لديك.
امنح كل وكيل الـ checkout الخاص به
نزّل AgentsRoom لنظام macOS أو Windows أو Linux ودع عدة وكلاء يعملون على المستودع نفسه دون أن يتعثر أحدهم بالآخر.
التطبيق المرافق: تابع وكلاءك أينما كنت
استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.
أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.