Worktrunk git worktree: مستودع max-sixty/worktrunk أداة سطر أوامر مكتوبة بلغة Rust تبسّط إدارة worktrees في Git. يصفها ملف README بأنها «مصمَّمة لتشغيل وكلاء الذكاء الاصطناعي بالتوازي». تُنشر بترخيص مزدوج MIT أو Apache 2.0 حسب الاختيار. ويقدّم README الأداة على أنها مدير worktrees الأكثر شعبية في Git، وهذا ادعاء من المشروع نفسه لا نتبنّاه.
المشكلة عملية. عندما يعمل خمسة وكلاء برمجة أو عشرة بالتوازي، يحتاج كل منهم إلى مجلد عمل خاص به. تتيح worktrees الأصلية في Git ذلك، لكن صياغة أوامرها ثقيلة. فكيف تخفّف Worktrunk هذه الخطوة، وكيف تُثبَّت، وماذا يمكن رصده عند تشغيل الأداة على جهاز المطوّر؟
توضيح للأمانة: لم تثبّت span.observer أداة Worktrunk ولم تشغّلها. الأوامر مأخوذة من README ومن وثائق المستودع (مجلد docs/ المنشور على worktrunk.dev)، وقد قُرئت في 5 نوفمبر 2026. تعيد اللقطات إنتاج أمثلتها. لم يمكن التحقق من عدد النجوم في المصدر، لذلك لا نذكره.
Worktrunk git worktree: ما يقوله المستودع
- الترخيص: يتضمن ملف LICENSE نصَّي MIT وApache 2.0، ويذكر
Cargo.tomlالقيمةMIT OR Apache-2.0. - الإصدار: يحمل
Cargo.tomlوأول مدخل في سجل التغييرات الإصدار 0.81.0. لا يُذكر تاريخ هذا الإصدار في السجل، لذلك لا نذكره. الرقم 0.x يدل على مشروع ما زال حديثًا. - المبدأ: يُشار إلى worktrees باسم الفرع، ويُحسب المسار من قالب قابل للضبط. تشكّل ثلاثة أوامر النواة:
wt switchوwt listوwt remove، إضافة إلىwt mergeللدمج. - الوكلاء: توجد إضافات (plugins) لـ Claude Code وCodex وOpenCode وPi وoh-my-pi وGemini CLI. بحسب الوثائق، توفّر تتبّع النشاط في
wt list، وعزل worktrees لـ Claude Code وOpenCode فقط.
يقارن README الأوامر بـ Git وحده: إنشاء worktree وتشغيل Claude ينتقل من ثلاثة أوامر متسلسلة (git worktree add -b ثم cd ثم claude) إلى أمر واحد هو wt switch -c -x claude feat.
جولة في الأوامر والوثائق
تعرض اللقطة الأولى البدء السريع من README: إنشاء worktree ثم عرض حالة كل فرع. حُذفت الأعمدة Commit وAge وMessage ليتسع العرض في 860 بكسل، وبقية المحتوى كما هو.

توضّح الوثائق الرموز: يدل @ على worktree الحالية، و+ على تغييرات مجهّزة للإيداع، و↑1 على commit متقدّم عن main، و⇡ على commits لم تُدفع. ولتشغيل عدة وكلاء، يعطي README ثلاثة أوامر wt switch -x claude -c، حيث يشغّل الخيار -x أمرًا بعد تبديل worktree. تُكتب hooks في الوثائق بصيغة TOML، وتجمع اللقطة الثانية بينها وبين الأوامر.

في هذا المثال من الوثائق، يُنفَّذ install أولًا، ثم يُنفَّذ build وserver معًا. وتعمل hooks من النوع post-* في الخلفية.
التثبيت خطوة بخطوة
الخطوة 1: تثبيت الأمر wt
يقترح README استخدام Homebrew (على macOS وLinux) أو Cargo أو مديري حزم آخرين:
brew install worktrunk && wt config shell install
# or
cargo install worktrunk && wt config shell install
يتيح تكامل الأداة مع shell أن تغيّر الأوامر المجلد الحالي. على Windows يتعارض الأمر wt مع أمر Windows Terminal، لذلك يثبّت Winget الأداة باسم git-wt (الأمر winget install max-sixty.worktrunk ثم git-wt config shell install). وتوضح الأسئلة الشائعة (FAQ) أن Git for Windows مطلوب لأن الـ hooks تُنفَّذ عبر Git Bash، وتذكر Git 2.43 أو أحدث شرطًا مسبقًا. كما تُدرج Arch Linux (pacman) وConda أو Pixi.
الخطوة 2: إنشاء worktree
- داخل مستودع Git، شغّل
wt switch --create feature-auth: ينشئ الأمر الفرع انطلاقًا من الفرع الافتراضي، وينشئ worktree. - اعمل على الفرع، ثم راجع الحالة العامة بالأمر
wt list. - أنهِ العمل بمسار pull request (
wt step commitثمgh pr createثمwt removeبعد الدمج)، أو بالأمرwt merge mainالذي يجمع squash وrebase والدمج والتنظيف.
الخطوة 3: تشغيل عدة وكلاء
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
تُمرَّر الوسائط التي تلي -- إلى الأمر المشغَّل. بحسب الوثائق، ينفّذ wt switch أولًا hooks من النوع pre-start وهي حاجبة، ثم يشغّل hooks من النوع post-start في الخلفية.
الخطوة 4 (اختيارية): إضافة الوكيل
wt config plugins claude install
تضيف الإضافة مؤشرات نشاط في wt list: الرمز 🤖 عندما يعمل الوكيل، والرمز 💬 عندما ينتظر. تعيد اللقطة الثالثة مثال الوثائق.

الحدود ونقاط مفتوحة
- النضج: الإصدار 0.81.0، وسجل تغييرات يشير إلى تغييرات غير متوافقة («Breaking») في هذا الإصدار نفسه، خصوصًا في الـ hooks والقوالب. اقرأه قبل كل ترقية.
- الـ hooks والأمان: تطلب أوامر hooks المشروع موافقة عند أول تنفيذ، وتُسجَّل في
~/.config/worktrunk/approvals.toml. يتجاوز الخيار--yesالأسئلة: احتفظ به للتكامل المستمر. تنفّذ hook المشروع أوامر قادمة من المستودع، فراجع.config/wt.tomlفي أي مستودع تابع لجهة أخرى قبل الموافقة. - الوكلاء بالتوازي: تحذّر الوثائق من أن hooks المتزامنة قد تتنافس على ملف واحد. استخدم كتلًا مرتبة للأوامر المعتمدة بعضها على بعض. راجع أيضًا ضوابط الحماية لوكلاء الذكاء الاصطناعي في الإنتاج.
- القرص: تضيف كل worktree نسخة من الملفات المتتبَّعة. ونسخ ذاكرات البناء المؤقتة (
wt step copy-ignored) تتشارك كتل القرص في APFS وbtrfs وXFS فقط، لا في ext4 ولا NTFS. - الفروع المتراكبة: غير مدعومة أصلًا بحسب الأسئلة الشائعة.
- التكاملات: تمر حالات CI عبر أداة سطر الأوامر الخاصة بمنصة الاستضافة (
ghأوglabأوteaأوaz) وتتطلب الشبكة مع الخيار--full.
رصد Worktrunk ووكلائها
Worktrunk أداة سطر أوامر محلية وليست خدمة. لا يوثّق المستودع مقاييس ولا تصديرًا إلى OpenTelemetry، وتؤكد الوثائق أن الأداة لا تجمع أي قياسات عن بُعد (telemetry) ولا إحصاءات استخدام، لذلك لا نفترض وجود شيء منها. أما الموجود فهو موثّق:
- سجل الأوامر:
.git/wt/logs/commands.jsonl، سطر JSON واحد لكل تنفيذ hook أو أمر LLM، بالحقولtsوwtوlabelوcmdوexitوdur_ms. يدور الملف عند بلوغ 1 ميغابايت. - سجلات الـ hooks في الخلفية: ملف لكل hook في
.git/wt/logs/{branch}/{source}/{hook-type}/{name}.log، ويعرضها الأمرwt config state logs. - التشخيص: يكتب الخيار
-vvالملفاتtrace.logوtrace.jsonlوsubprocess.log، ويلخّصwt config state logs profileالمدد. - حالة الوكلاء: المؤشران 🤖 و💬 في
wt list. قد يبقى مؤشر إذا أُنهي الوكيل قبل نهاية الجلسة، ويمسحه الأمرwt config state marker clear.
لقياس ما يفعله الوكلاء أنفسهم (التكلفة واستدعاءات الأدوات والمدد)، يكون ذلك بتجهيز الوكيل بأدوات القياس: راجع مراقبة وكيل البرمجة في المؤسسة. ولإدارة أسطول من الوكلاء، قارن مع Orca.
وماذا عن Dynatrace؟
لا توثّق Worktrunk أي تكامل مع Dynatrace، ولا نختلق واحدًا. يمكن لأداة جمع سجلات قراءة الملف commands.jsonl، ويعود الضبط حينئذٍ إلى وثائق أداة الجمع المستخدمة.
أفضل الممارسات
- worktree واحدة لكل وكيل ولكل مهمة، باسم الفرع، ثم
wt removeبعد الدمج. - ضع تثبيت الاعتماديات في
pre-startوخوادم التطوير فيpost-start، كما توصي الوثائق. - راجع hooks المشروع قبل الموافقة عليها، ولا تضع أي سر في
.config/wt.toml. - اطّلع على
commands.jsonlعند فشل hook: ففيه رمز الخروج والمدة. - زوّد وكلاءك بخادم MCP موثوق، مثل خادم GitHub MCP.
الأسئلة الشائعة
هل تحل Worktrunk محل git worktree؟
لا: تعتمد الأداة على Git وعلى worktrees فيه. وتضيف الإشارة إلى worktree باسم الفرع، والـ hooks، وعرض الحالة، ومسار الدمج. وتبقى worktrees لديك worktrees عادية في Git.
هل تعمل Worktrunk مع وكلاء غير Claude Code؟
بحسب الوثائق، توجد إضافات لـ Codex وOpenCode وPi وoh-my-pi وGemini CLI. تختلف الوظائف: عزل worktrees متاح لـ Claude Code وOpenCode فقط. أما بقية الوكلاء فتُستخدم مع wt switch --create وwt remove.
هل ترسل Worktrunk بيانات؟
تؤكد الوثائق أنها لا تجمع أي قياسات عن بُعد. تشغّل الأداة git وتشغّل اختياريًا أداة سطر الأوامر الخاصة بمنصة الاستضافة لمعرفة حالة CI، إضافة إلى أوامر LLM التي تضبطها أنت بنفسك.
الخلاصة
تقلّل Worktrunk العمل المتكرر حول worktrees في Git، وهذا مهم متى عمل عدة وكلاء برمجة بالتوازي. الأداة حديثة وتتغير بسرعة، ولا توثّق أي مقاييس: يعتمد الرصد على سجلاتها وعلى تجهيز الوكلاء بأدوات القياس. جرّبها على مستودع غير حساس قبل تعميم استخدامها.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لـ Worktrunk ولا لمؤلفها ولا لشركة Dynatrace LLC. العلامات المذكورة تعود إلى مالكيها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.