بعد أن تعتاد على وكيل برمجة Coding Agent واحد، يأتي اليوم الذي تفكر فيه بتشغيل اثنين أو ثلاثة في الوقت نفسه: واحد يصلح علة Bug، وآخر يضيف ميزة Feature صغيرة، وثالث يكتب اختبارات Tests لجزء قديم. والفكرة منطقية، فالوكيل يقضي أغلب وقته يفكر أو ينتظر النموذج، وأنت في هذا الوقت لا تفعل شيئاً. ولكن بعد نصف ساعة تجد نفسك تمر على ثلاث نوافذ طرفية واحدة واحدة لتعرف أي وكيل انتهى، وأيها ما زال يعمل، وأيها يقف منذ عشرين دقيقة أمام سؤال «هل أشغل هذا الأمر؟» ينتظر أن تضغط Enter. وإذا أغلقت نافذة بالخطأ ضاع عمل الوكيل الذي فيها.
هذه المشكلة هي التي بنيت من أجلها أداة herdr، وهي مفتوحة المصدر بترخيص Apache-2.0، وتشغل وكلاءك في طرفيات حقيقية تعيش في خادم Server في الخلفية، وتعرض في قائمة جانبية حالة كل وكيل: يعمل Working، أو ينتظرك Blocked، أو انتهى Done، وتصل إليها من جهازك أو من سيرفر عبر SSH أو من الجوال. وفي هذا المقال لن نكتفي بقراءة صفحاتها، وإنما سوف نثبتها في حاوية Container، ونشغل فيها وكيلين من OpenCode على نموذج محلي صغير عبر Ollama، كل منهما في Worktree خاصة به، ونسجل كل تغير في حالتهما، ونقطع الاتصال ونرجع، ونضيف سيرفراً ثانياً، ونجرب الجيل الجديد منها herdr-core، ونعرف أين تفشل.
وسوف نناقش في هذا المقال ما يلي:
- لماذا يحتاج تشغيل عدة وكلاء بالتوازي إلى مدير، ولماذا لا تكفي الألسنة Tabs ولا tmux وحده.
- ما هو herdr: البرنامج الأصلي Herdr TUI، والجيل الجديد herdr-core وتطبيق سطح المكتب وتطبيق الجوال، والفرق بينها.
- كيف يعرف herdr أن الوكيل يعمل أو ينتظرك: قراءة الشاشة بقواعد، وتقارير الوكيل، وبروتوكول OSC 7501.
- مختبر حقيقي: التثبيت، وWorktree لكل مهمة، ووكيلان على نموذج محلي، وسجل الحالات كما حدثت، والانفصال والرجوع، وسيرفر ثان عبر SSH.
- الحدود: الوكيل داخل tmux لا يرى herdr حالته، والنموذج المحلي الواحد لا يخدم وكيلين بسرعة، وما الذي يرجع بعد إعادة التشغيل.
- مقارنة قصيرة مع Claude Squad وccmanager وConductor وtmux من صفحاتها الرسمية، ثم الأخطاء الشائعة وقائمة التحقق.
وهذا المقال يبني على مقالات سابقة في المسار، فـ Worktree لكل مهمة والرجوع الآمن في Git شرحناهما في مقال Git مع وكلاء البرمجة، والوكلاء أنفسهم في مقارنة الوكلاء ومقال الوكلاء مفتوحة المصدر، والنموذج المحلي وحدوده في مقاله الخاص، والفرق بين مدير الجلسات وبين التقسيم داخل الطرفية في مقارنة أدوات تعدد الجلسات:
دليلGit مع وكلاء البرمجة: فروع وWorktrees ورجوع آمنفرع وWorktree لكل مهمة، وcommit صغير برسالة تقول من كتبه، وفحص لا يتجاوزه الوكيل، وطريق معروف للرجوع، مع مختبر حقيقي فيه خطاف لم يعمل وcommit أوقف المشروع وجده git bisect.
دليلمقارنة وكلاء البرمجة: Claude Code وCodex وCursor وCopilotمقارنة الوكلاء المعروفة والمفتوحة بما يهم فريقك فعلاً: أين تنفذ الأوامر، وأي النماذج تقبل، وكم تدفع في السنة، وماذا يفعل المزود بالكود، مع ثلاثة وكلاء شغلناهم على مهمة واحدة.
دليلوكيل برمجة بنموذج محلي Local LLM مع Ollama: ماذا تتوقع؟خمسة نماذج برمجة على معالج عادي دون بطاقة رسومية: كم تأخذ من الذاكرة، وكم تنتظر قبل أول كلمة، وكم دالة تكتبها صحيحة، وهل يصلح الوكيل علة بنفسه.
دليلtmux أم Zellij أم screen؟ مقارنة مديري الجلسات Multiplexersشغلنا tmux وZellij وscreen والتقسيم المدمج في WezTerm وkitty في حاوية واحدة، وقسنا الذاكرة وزمن البدء، وجربنا ما يرجع بعد إعادة الإقلاع وكيف يظهر النص العربي في كل أداة.
دليلالوكلاء الفرعيون Subagents والعمل بالتوازي في فروع منفصلةكيف يعمل الوكيل الفرعي في Claude Code وCodex وCursor، ومتى يفيد عزل القراءة والكتابة في Worktree لكل وكيل، مع تجربة على نموذج محلي فيها أخطاء مزروعة وإصلاحات في فروع منفصلة وتعارض حقيقي.لماذا يحتاج تشغيل عدة وكلاء بالتوازي إلى مدير؟
قد يتساءل البعض: لماذا أحتاج أداة جديدة إذا كان كل وكيل برنامجاً يعمل في الطرفية؟ والإجابة على ذلك أن المشكلة لا تظهر مع وكيل واحد، وإنما تظهر عندما يصبح انتباهك هو المورد الذي يتقاسمه الوكلاء. ولنمر على الحلول بالترتيب الذي يمر به أغلب الناس.
الحل البسيط أن تفتح لكل وكيل لساناً في برنامج الطرفية، وهذا يعمل في الدقائق الأولى، ولكنه يفشل لثلاثة أسباب: الوكلاء الثلاثة يعدلون نفس المجلد فيكتب أحدهم فوق ملف الآخر، ولا يوجد شيء يقول لك أيهم ينتظرك فتمر عليها بنفسك، وإغلاق النافذة أو إعادة تشغيل الحاسوب للتحديث توقف الوكلاء جميعاً. والمشكلة الأولى حلها معروف وشرحناه في مقال Git مع وكلاء البرمجة: فرع Branch وWorktree لكل مهمة، فيرى كل وكيل مجلده فقط.
والحل التالي أن تضع الوكلاء داخل tmux، وهذا يحل مشكلة إغلاق النافذة وانقطاع الاتصال، لأن الخادم هو الذي يملك الطرفيات كما شرحنا في دليل tmux. ولكن tmux لا يعرف أن البرنامج الذي في الجزء وكيل، ولا يفرق بين وكيل يفكر ووكيل يقف أمام سؤال، فما زلت تمر على الأجزاء بنفسك. والحل الثالث هو مدير مخصص للوكلاء يجمع الاثنين: طرفيات تعيش في خادم مثل tmux، ومعها فهم لحالة كل وكيل يعرضه في مكان واحد. والصورة التالية تبين الفرق:

ولاحظ أن المدير لا يجعل الوكيل أذكى ولا أسرع، فهو لا يغير شيئاً في الكود الذي يكتبه، وإنما يغير شيئاً واحداً: أين تضع انتباهك. والقاعدة التي تخرج بها من هذا القسم أن عدد الوكلاء الذين تستطيع أن تشغلهم بالتوازي لا يحدده المعالج ولا الاشتراك، وإنما عدد القرارات التي تستطيع أن تراجعها في الساعة، والمدير الجيد يقلل الوقت الضائع بين القرار والقرار.
ما هو herdr؟ ثلاثة برامج تحت اسم واحد
أول ما يربك القارئ في صفحات herdr أن الاسم يطلق اليوم على أكثر من برنامج، والفرق بينها مهم لأنها لا تتشارك الوكلاء. فالبرنامج الأصلي اسمه اليوم Herdr TUI، وهو برنامج يعمل داخل الطرفية مكتوب بلغة Rust في مستودع herdrdev/herdr، وآخر إصدار مستقر منه 0.9.5 بتاريخ 14 أكتوبر 2026، وهو إصلاح سريع للإصدار 0.9.4 الذي صدر في 13 أكتوبر كما في صفحة الإصدار. أما الجيل الجديد فيقوم على herdr-core، وهو خادم صغير وأمر اسمه hc يشغل البرامج في طرفيات تبقى ولا يرسم أي واجهة، وإصداره 0.1.21، وفوقه تطبيق Herdr لسطح المكتب بإصدار 0.1.16، وتطبيق للجوال على iPhone وAndroid يتصل بـ herdr-core عبر SSH كما تشرح صفحة الجوال.

والأسئلة الشائعة في الصفحة الرئيسية تقول ذلك صراحة: التطبيق برنامج جديد منفصل مبني على herdr-core، وHerdr TUI له خادمه الخاص، والوكيل الذي يعمل في أحدهما لا يظهر في الآخر، وHerdr TUI ما زال يعمل ويتطور. وفي الجدول التالي ما تحتاج أن تعرفه عن كل واحد:
| البرنامج | الأمر | الإصدار | أين يعمل | كيف يعرف الحالة |
|---|---|---|---|---|
| Herdr TUI | herdr | 0.9.5 | داخل أي طرفية، على Linux وmacOS وWindows | يقرأ الشاشة لنحو 22 وكيلاً معروفاً، أو يأخذ تقارير الوكيل |
| herdr-core | hc | 0.1.21 | خادم دون واجهة، على Linux وmacOS وWindows | بروتوكول OSC 7501 فقط |
| تطبيق Herdr | herdr-app | 0.1.16 | سطح المكتب، وعلى Linux يحتاج جلسة سطح مكتب وتعريف Vulkan | من herdr-core |
| تطبيق الجوال | من المتجر | - | iPhone وiPad وAndroid | من herdr-core عبر SSH |
وفي المختبر شغلنا Herdr TUI لأنه البرنامج الذي يعمل كاملاً في الطرفية ويمكن أن نصوره دون سطح مكتب، ثم جربنا herdr-core وحده بالأمر hc. أما تطبيق سطح المكتب فلم نشغله، لأن نسخته على Linux تحتاج سطح مكتب وتعريف Vulkan كما في README الخاص به، وما نقوله عنه هنا من وثائقه. ونقطة أخيرة قبل التفاصيل: الإعداد في الجيل الجديد ملفات نصية في المجلد ~/.config/herdr-app، فيها التخطيطات Layouts والمفاتيح والسمات، وفيها ملف AGENTS.md يشرح لوكيلك كيف يعدلها، فتطلب من الوكيل «ضع مؤقتاً على كل لسان» فيكتب هو الإضافة Mod بلغة JavaScript، كما تشرح صفحة الدليل.
كيف يعرف herdr أن الوكيل يعمل أو ينتظرك؟
هذا هو القسم الأهم في المقال، لأن قيمة الأداة كلها في دقة الحالة التي تعرضها. فإذا قالت إن الوكيل يعمل وهو في الحقيقة ينتظرك فأنت أسوأ حالاً مما لو لم تستعملها، لأنك تثق بها ولا تنظر. وهناك ثلاث طرق تعرف بها عائلة herdr حالة البرنامج، والصورة التالية تجمعها:

الطريقة الأولى: قراءة الشاشة بقواعد Detection Manifests
Herdr TUI يعرف قائمة من الوكلاء، تذكر صفحة الوكلاء في وثائقه منها Claude Code وCodex وGitHub Copilot CLI وCursor Agent وOpenCode وGemini CLI وCline وغيرها. فيبحث أولاً عن عملية الوكيل في المقدمة Foreground داخل كل جزء، فإذا وجد مثلاً عملية opencode قرأ آخر الشاشة، أي الجزء الحي منها لا الجزء الذي صعدت إليه، وطابقه بقواعد مكتوبة في ملف لكل وكيل اسمه Manifest. وهذا ملف OpenCode كما وجدناه في الحاوية بعد أول تشغيل، بعد حذف قاعدتين تشبهان ما فيه:
id = "opencode"
version = "2026.06.10.1"
min_engine_version = 1
updated_at = "2026-06-10T00:00:00Z"
aliases = ["open-code", "herdr:opencode"]
[[rules]]
id = "permission_required"
state = "blocked"
priority = 300
region = "whole_recent"
visible_blocker = true
any = [
{ contains = ["△ Permission required"] },
]
[[rules]]
id = "progress_bar_working"
state = "working"
priority = 100
region = "whole_recent"
visible_working = true
regex = ['(■|⬝){4,}']وفي الملف أعلاه لاحظ التالي:
- كل قاعدة تقول: إذا وجدت هذا النص أو هذا التعبير في آخر الشاشة فالحالة كذا، والأولوية
priorityتقرر أي قاعدة تفوز إذا تطابقت أكثر من واحدة، فقاعدة طلب الإذن بأولوية 300 تغلب قاعدة شريط التقدم بأولوية 100. - قاعدة
progress_bar_workingتبحث عن أربعة مربعات أو أكثر متتالية، وهي الشريط المتحرك الذي يرسمه OpenCode أسفل الشاشة أثناء العمل. - الملف لم يأت مع البرنامج وإنما من موقع herdr.dev، ووجدناه في
~/.local/state/herdr/agent-detection/remote/مع ملفات لـ Claude Code وCodex وCopilot وCursor وغيرها، والوثائق تقول إن herdr يحدث هذه القواعد من الموقع دون أن تعيد تشغيله، ويمكن أن توقف ذلك بالخيار[update] manifest_check = false، أو تضع ملفك في~/.config/herdr/agent-detection/فيغلب أي ملف آخر.
وقوة هذه الطريقة أنها تعمل مع الوكيل كما هو دون أي تعديل فيه، وضعفها أنها تخمين: فإذا غير الوكيل شكل شاشته في إصدار جديد فقد تخطئ القواعد حتى يتحدث الملف. والوثائق صريحة في هذا: herdr لا يضع الحالة blocked إلا إذا طابق شكل سؤال يعرفه، وإذا لم يطابق شيئاً لوكيل يعرفه فإنه يرجع إلى idle، أي أن السؤال الجديد الذي لم يتعلمه بعد قد يظهر لك كأن الوكيل جاهز. ولذلك لا تجعل سكربتاً يكتب في الوكيل لمجرد أن حالته idle دون أن يقرأ شاشته.
الطريقة الثانية: الوكيل يرسل تقريراً بنفسه
كل برنامج يعمل في جزء من Herdr TUI يرث متغيرات بيئة Environment Variables منها HERDR_ENV=1 وHERDR_PANE_ID وHERDR_BIN_PATH، فيستطيع الوكيل أن يرسل حالته بالأمر herdr pane report-agent كما تشرح صفحة إضافة دعم herdr إلى وكيلك، ويرسل معها أمر الاستئناف Resume Command الذي يرجع نفس الحوار. وهذا ما تفعله التكاملات Integrations التي يثبتها herdr لبعض الوكلاء بالأمر herdr integration install opencode، فتصبح الحالة من الوكيل نفسه بدلاً من الشاشة، ويرجع الحوار بعد إعادة تشغيل الخادم. والتكامل ليس سحراً، فهو ملف صغير يضعه herdr في إعداد الوكيل نفسه، والأمر herdr integration status يعرض المسار لكل وكيل، ومنه في حاويتنا:
claude: not installed (/home/dev/.claude/hooks/herdr-agent-state.sh)
codex: not installed (/home/dev/.codex/herdr-agent-state.sh)
opencode: not installed (/home/dev/.config/opencode/plugins/herdr-agent-state.js)أي أنه خطاف Hook بلغة Shell لـ Claude Code وCodex، وإضافة Plugin بلغة JavaScript لـ OpenCode. وعندما ثبتناه لـ OpenCode في آخر المختبر بالأمر herdr integration install opencode كتب ثلاثة ملفات: الإضافة herdr-agent-state.js في 224 سطراً، وإضافة للواجهة herdr-tui-session.js، وسطراً في tui.jsonc يفعلها، فإذا أردت أن تعرف ماذا يفعل التكامل فافتح هذه الملفات واقرأها قبل أن تعتمد عليه. وسوف نكتب في المختبر سكربتاً صغيراً يرسل حالته بهذه الطريقة ونشغله على سيرفر ثان.
الطريقة الثالثة: بروتوكول OSC 7501
أما herdr-core والتطبيق الذي فوقه فلا يقرآن الشاشة أبداً، ويقول README الخاص به إنه لا يخمن من نص الشاشة ولا يعرف أسماء الوكلاء، والبرنامج الذي لا يرسل حالته ليس له حالة. والإرسال يكون بتسلسل هروب Escape Sequence يطبعه البرنامج في مخرجه ولا يظهر على الشاشة، اسمه بروتوكول حالة البرامج Program Status Protocol ورقمه OSC 7501، والمثال الذي تضعه الصفحة الرئيسية سطر واحد:
printf '\e]7501;state=blocked:app=my-agent\e\\'وهذا التصميم أنظف من قراءة الشاشة، لأن البرنامج وحده يعرف بدقة هل هو يفكر أم ينتظر، ولكنه يعني أن الأداة تعتمد على أن يدعم كل وكيل هذا البروتوكول، والوكيل القديم الذي لا يرسله يظهر كطرفية عادية دون حالة.
تجهيز المختبر: حاوية ونموذج محلي ومستودع صغير
بنينا المختبر من ثلاث حاويات على شبكة Docker واحدة: حاوية الحاسوب hrd-herdr من Debian 13 trixie فيها Herdr TUI وherdr-core وOpenCode 2.3.2 مع Xvfb وxterm للقطات الشاشة، وحاوية hrd-ollama من الصورة ollama/ollama:0.40.13 فيها النموذج qwen3:4b-instruct بحجم 2.5 جيجابايت على المعالج دون بطاقة رسومية، وحاوية ثالثة hrd-workbox تمثل سيرفراً نصل إليه عبر SSH. والنموذج المحلي هنا اختيار مقصود: لا مفاتيح API ولا حسابات، وكل ما يكتبه الوكيل يبقى على الجهاز، وقد شرحنا حدوده في مقال النموذج المحلي.
والمستودع الذي يعمل عليه الوكيلان صغير جداً، فيه ملف textkit.py بدالتين واختباراته، وفيه علة مقصودة: الدالة slugify لا تحذف علامات الترقيم، فاختبار من الثلاثة يفشل:
def slugify(title):
"""Lower-case words joined by '-', without punctuation: 'Hello, World!' -> 'hello-world'."""
return "-".join(title.lower().split())
def word_count(text):
"""Number of words separated by whitespace."""
return len(text.split())وإعداد OpenCode يشير إلى Ollama في الحاوية الأخرى، ويسمح للوكيل بتعديل الملفات دون سؤال، ولكنه يسأل قبل تشغيل أي أمر في الـ Shell، والسبب أننا نريد أن نرى حالة blocked حقيقية في herdr عندما يطلب الوكيل تشغيل الاختبارات:
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"ollama": {
"settings": {
"baseURL": "http://hrd-ollama:11434/v1",
"headerTimeout": false,
"chunkTimeout": false,
"timeout": false
},
"models": {
"qwen3:4b-instruct": {}
}
}
},
"model": "ollama/qwen3:4b-instruct",
"permission": {
"edit": "allow",
"bash": "ask"
}
}والخيارات الثلاثة التي تنتهي بـ Timeout لم تكن في النسخة الأولى من الملف، وأضفناها بعد مشكلة حقيقية سوف نعرضها في قسمها.
التثبيت: اقرأ السكربت قبل أن تشغله
الطريقة الرسمية لتثبيت Herdr TUI على Linux وmacOS سطر واحد هو curl -fsSL https://herdr.dev/install.sh | sh، وهذا النوع من الأوامر يشغل كوداً من الإنترنت بصلاحياتك دون أن تراه. ولذلك نزلنا السكربت أولاً وقرأناه: يقرأ ملف https://herdr.dev/latest.json ليعرف الإصدار ورابط الملف الثنائي لنظامك، وينزله من صفحة الإصدارات في GitHub، ويتحقق من بصمة SHA-256 المكتوبة في نفس الملف، ثم يضعه في ~/.local/bin، ولا يطلب صلاحيات root ولا يعدل أي ملف آخر. وبعد القراءة شغلناه في الحاوية، وتأكدنا أن بصمة السكربت الذي نزل داخل الحاوية هي بصمة السكربت الذي قرأناه:
curl -fsSL https://herdr.dev/install.sh -o /tmp/install.sh && sha256sum /tmp/install.sh && sh /tmp/install.shوالمخرج سوف يكون كما يلي:
bf83668c944cff30b3365eee5a4fe15ff61a4b749ab0c73b98e7a203f70893dd /tmp/install.sh
,ww
wWWWWWWW_) herdr installer
`WWWWWW' herdr.dev
II II
> detected linux/x86_64
> fetching latest release manifest...
> downloading v0.9.5...
> installed herdr to /home/dev/.local/bin/herdr
! /home/dev/.local/bin is not in your PATH
add it to your shell config:
export PATH="/home/dev/.local/bin:$PATH"في المخرج أعلاه لاحظ التالي:
- السكربت لم يضف المجلد إلى
PATHبنفسه، وإنما طبع السطر الذي تضيفه أنت، وهذا تصرف صحيح لأنه لا يعدل ملفات الإعداد دون إذنك. - الملف الثنائي نفسه 30 ميجابايت، وبصمته
14d9e8bc…طابقت البصمة فيlatest.jsonعندما نزلناه يدوياً على جهازنا قبل التجربة. - herdr-core يثبت بنفس الطريقة من
https://releases.herdr.dev/core/install.sh، وقرأناه أيضاً قبل التشغيل، فوجدناه يتحقق من البصمة ويضع الأمرhcكرابط إلىherdr-coreفي نفس المجلد.
ثم ثبتنا herdr-core وفككنا OpenCode من ملفه الرسمي، وهذا ما طبعه سكربت herdr-core مع الإصدارات:
hc 0.1.21 installed into /home/dev/.local/bin/herdr-core.
Agents: hc --skill. People: hc --help.
herdr 0.9.5
hc 0.1.21
opencode v2.3.2أول تشغيل: المساحة واللسان والتكاملات
شغلنا herdr من داخل مجلد المستودع في xterm، فبدأ الخادم في الخلفية وظهرت الواجهة ومعها نافذة ترحيب:

والمساحة Space في herdr هي مشروع أو مستودع، وفيها ألسنة Tabs، وكل لسان يقسم إلى أجزاء Panes، وكل جزء طرفية حقيقية. وبعد Enter عرض herdr قائمة التكاملات المتاحة، ووجد OpenCode وحده لأنه الوكيل الوحيد المثبت:

ولم نثبت التكامل في البداية عن قصد، لأننا أردنا أن نرى الطريقة الأولى وحدها، أي قراءة الشاشة، ثم نقارن.
Worktree لكل مهمة من herdr نفسه
في مقال Git مع الوكلاء صنعنا الـ Worktrees بالأمر git worktree add يدوياً، أما herdr ففيه أمر يصنع الـ Worktree ويفتحها كمساحة مستقلة مجمعة تحت المستودع الأصلي:
herdr worktree create --workspace w1 --branch agent/fix-slugify --label fix-slugify --no-focus
herdr worktree create --workspace w1 --branch agent/reading-time --label reading-time --no-focus
git worktree listوالمخرج، بعد أن اختصرنا JSON الذي يعيده herdr إلى الحقول المهمة، سوف يكون كما يلي:
{"ws":"w2","label":"fix-slugify","pane":"w2:p1","wt":{"branch":"agent/fix-slugify","is_linked_worktree":true,"path":"/home/dev/.herdr/worktrees/textkit/agent-fix-slugify"}}
{"ws":"w3","pane":"w3:p1","wt":{"branch":"agent/reading-time","is_linked_worktree":true,"path":"/home/dev/.herdr/worktrees/textkit/agent-reading-time"}}
/home/dev/work/textkit 1706733 [main]
/home/dev/.herdr/worktrees/textkit/agent-fix-slugify 1706733 [agent/fix-slugify]
/home/dev/.herdr/worktrees/textkit/agent-reading-time 1706733 [agent/reading-time]في المخرج أعلاه لاحظ التالي:
- herdr وضع الـ Worktrees في
~/.herdr/worktrees/<repo>/<branch>، وهذا المسار الافتراضي يمكن أن تغيره بالخيار[worktrees] directoryفي ملف الإعداد~/.config/herdr/config.toml. - كل Worktree صارت مساحة لها رقم
w2وw3، وجزء أولw2:p1، وهذه العناوين هي التي نستعملها في كل الأوامر التالية. git worktree listيرى الثلاثة، أي أن herdr لم يخترع شيئاً خاصاً به، وإنما استعمل Git العادي، فتستطيع أن تدمج وتحذف بأوامر Git كما تعودت. وإذا حذفت الـ Worktree من القائمة فإن herdr يشغلgit worktree removeويسألك قبل الحذف بالقوة إذا كان فيها تعديلات، ولا يحذف الفرع.
تشغيل وكيلين وإعطاؤهما المهمة
تستطيع أن تكتب opencode في كل جزء بنفسك، وherdr يكتشفه، ولكن الأمر herdr agent start يعطي الوكيل اسماً تستعمله في الأوامر التالية، ولا يرجع إلا بعد أن يرى الوكيل جاهزاً:
herdr agent start fixer --kind opencode --pane w2:p1
herdr agent start feature --kind opencode --pane w3:p1
herdr agent list | jq -c '.result.agents[]|{name,pane_id,agent,agent_status,workspace_id}'والمخرج سوف يكون كما يلي:
{"name":"fixer","pane_id":"w2:p1","agent":"opencode","agent_status":"idle","workspace_id":"w2"}
{"name":"feature","pane_id":"w3:p1","agent":"opencode","agent_status":"idle","workspace_id":"w3"}وأخذ كل أمر agent start نحو ثلاث ثوان ونصف، وهو الوقت الذي احتاجه OpenCode ليرسم شاشته فيراها herdr جاهزة. ثم أعطينا كل وكيل مهمته بالأمر herdr agent prompt، وهو يكتب النص في الوكيل ويضغط Enter:
herdr agent prompt fixer "In textkit.py, slugify must drop punctuation so that slugify(\"Hello, World!\") returns \"hello-world\". Fix it, then run: python3 -m unittest"
herdr agent prompt feature "Add a function reading_time(text, wpm=200) to textkit.py that returns the minutes needed to read the text, rounded up, at least 1. Add a test for it in test_textkit.py, then run: python3 -m unittest"الحالات كما سجلناها
لكي لا نعتمد على النظر إلى الشاشة كتبنا سكربتاً صغيراً اسمه watch.sh يسأل herdr عن الوكلاء كل ثانية ويكتب سطراً كلما تغيرت حالة أحدهم:
last=""
while true; do
now=$(herdr agent list 2>/dev/null | jq -r '[.result.agents[] | "\(.name // .pane_id)=\(.agent_status)"] | join(" ")')
if [ "$now" != "$last" ]; then echo "$(date +%T) $now"; last=$now; fi
sleep 1
doneوبعد إرسال المهمتين بثانيتين ظهر هذا السطر:
08:36:46 fixer=idle feature=idle
08:37:06 fixer=working feature=workingوالصورة التالية من نفس اللحظة، والوكيلان بلون أصفر في القائمة الجانبية تحت agents، وأمام كل مساحة في الأعلى نفس اللون:

ولكي نعرف لماذا قرر herdr أن الحالة working سألناه بالأمر herdr agent explain fixer، والمخرج سوف يكون كما يلي:
agent: opencode
state: working
manifest: remote:/home/dev/.local/state/herdr/agent-detection/remote/opencode.toml 2026.06.10.1
rule: progress_bar_working (region=whole_recent priority=100)
evidence: "\n ┃ New session - 2026-11-20T08:37:04.\n ┃ In textkit.py, slugify must drop punctuation so that slugify(\"Hello, 734Z\n ┃ World!\") returns \"hello-wo..."وهذا الأمر هو أول ما تستعمله إذا ظهرت حالة غريبة: يقول لك أي ملف قواعد استعمل وأي إصدار، وأي قاعدة طابقت، وما النص الذي رآه. وهنا طابقت قاعدة شريط التقدم التي رأيناها في ملف القواعد.
مشكلة حقيقية: خمس دقائق ثم إعادة المحاولة
بعد خمس دقائق تقريباً من إرسال المهمتين لم يكتب أي وكيل شيئاً، والحالة ما زالت working. وعندما نظرنا في سجل Ollama، أي السجلات Logs التي يكتبها الخادم لكل طلب، وجدنا هذه الأسطر:
[GIN] 2026/11/20 - 08:42:05 | 500 | 4m50s | 172.21.0.3 | POST "/v1/chat/completions"
[GIN] 2026/11/20 - 08:42:05 | 500 | 5m0s | 172.21.0.3 | POST "/v1/chat/completions"
[GIN] 2026/11/20 - 08:42:05 | 500 | 5m0s | 172.21.0.3 | POST "/v1/chat/completions"والسبب أن OpenCode ينتظر بداية الرد Response Headers خمس دقائق فقط، وهذه هي القيمة الافتراضية للخيار headerTimeout كما في ملف وصف الإعداد، بينما النموذج على معالجنا يقرأ الطلب الأول بسرعة نحو 9 رموز Tokens في الثانية، وطلب OpenCode الأول نحو 5,700 رمز بسبب تعليمات النظام System Prompt ووصف الأدوات، أي أكثر من عشر دقائق قبل أول رمز من الرد. فكان OpenCode يقطع الطلب عند خمس دقائق ويعيد المحاولة، والنموذج يبدأ من جديد، فلا ينتهي أي طلب. والحل كان الخيارات الثلاثة في الإعداد الذي عرضناه: headerTimeout وchunkTimeout وtimeout بالقيمة false.
ولاحظ ماذا كان herdr يعرض طوال هذا الوقت: working، وهذا صحيح من جهة الشاشة، فشريط التقدم يتحرك، ولكنه لا يعني أن شيئاً مفيداً يحدث. فالحالة في herdr تقول لك ماذا يعرض الوكيل، ولا تقول لك هل الوكيل يتقدم فعلاً، ولذلك إذا بقي وكيل working أطول مما تتوقع فافتح شاشته واقرأ سجل النموذج. وبعد تعديل الإعداد أوقفنا الوكيلين بالمفتاح ctrl+c عبر الأمر herdr agent send-keys، فاختفيا من قائمة الوكلاء بعد ثوان، لأن herdr يرى أن العملية خرجت والجزء رجع إلى الـ Shell، ثم شغلناهما من جديد بنفس الأوامر:
08:43:01 feature=working
08:43:02
08:43:25 fixer=unknown
08:43:28 fixer=idle feature=unknown
08:43:32 fixer=idle feature=idle
08:43:34 fixer=working feature=idle
08:43:35 fixer=working feature=workingوالسطر الفارغ عند 08:43:02 يعني أن قائمة الوكلاء صارت فارغة، والحالة unknown ظهرت لثوان بين بدء OpenCode ورسم شاشته، والوثائق تقول إنها تعني أن herdr وجد وكيلاً ولكنه لا يعرف حالته بثقة.
وكيلان على نموذج محلي واحد: كل منهما يبطئ الآخر
هنا ظهرت المشكلة الثانية، وهي ليست في herdr وإنما في فكرة التوازي نفسها مع نموذج محلي. فالخادم Ollama يخدم الطلبين على نفس المعالج، وكل طلب يقطع على الآخر الذاكرة المؤقتة للطلب السابق KV Cache، فيعيد قراءة آلاف الرموز من جديد. وهذا ما سجله Ollama لطلبات الوكيلين:
[GIN] 2026/11/20 - 09:02:26 | 200 | 18m50s | 172.21.0.3 | POST "/v1/chat/completions"
[GIN] 2026/11/20 - 09:16:53 | 200 | 29m40s | 172.21.0.3 | POST "/v1/chat/completions"
[GIN] 2026/11/20 - 09:16:57 | 200 | 33m20s | 172.21.0.3 | POST "/v1/chat/completions"
[GIN] 2026/11/20 - 09:34:33 | 200 | 47m20s | 172.21.0.3 | POST "/v1/chat/completions"أي أن طلباً واحداً، هو خطوة واحدة من خطوات الوكيل، احتاج 47 دقيقة. وفي هذا الوقت كان الوكيل الأول قد قرأ الملف فقط وكتب «Here's my fix for the slugify function:». فالحالة في herdr كانت صحيحة طوال الوقت، working للاثنين، ولكن التوازي هنا لم يوفر أي وقت، بل ضاعفه. ولذلك أوقفنا الوكيل الثاني بالمفتاح Esc لنترك المعالج للأول، وهذا ما سجله watch.sh:
09:35:31 fixer=working feature=doneوالحالة done تعني أن الوكيل توقف ولم تنظر إليه بعد، وهي تبقى في القائمة بلون مختلف حتى تفتحه، وهذا هو المقصود بالأداة: أن ترى أن شيئاً انتهى دون أن تكون أمامه. وفي اللقطة التالية الألوان الثلاثة معاً: الأصفر للوكيل الذي يعمل، والأخضر الفاتح للوكيل الذي توقف، والوردي لوكيل ينتظر موافقة على السيرفر الثاني الذي سنضيفه بعد قليل:

ساعتان دون سطر واحد: ماذا رأى herdr في النهاية؟
بعد أن أوقفنا الوكيل الثاني بقي الأول وحده، فأعدنا تشغيل Ollama بطلب واحد في الوقت نفسه بدلاً من اثنين، واستمر OpenCode في المحاولة. ولكن المعالج في هذا الوقت كان مشغولاً أيضاً بأعمال أخرى على نفس الجهاز، فنزلت سرعة توليد الرموز إلى نحو 0.3 رمز في الثانية، واحتاج الطلب التالي 52 دقيقة ثم بدأ طلب آخر، والوكيل لم يكتب بعد أي تعديل في الملف. وعند 10:51 ضغطنا Esc، فكتب OpenCode في أسفل شاشته 2h 8m · 0.0 tok/s · interrupted، وسجل watch.sh آخر سطر:
10:51:50 fixer=idle feature=idleولاحظ أن الحالة هنا idle وليست done كما حدث مع الوكيل الثاني، والسبب أن نافذة herdr كانت مفتوحة على هذا الوكيل نفسه، فاعتبره «مرئياً» لحظة توقفه. والصورة التالية تجمع كل ما سجلناه على خط زمني واحد:

والدرس من هذا الخط الزمني له وجهان. الأول أن herdr أدى عمله كما يجب: كل حالة ظهرت في القائمة كانت تطابق ما على الشاشة، وانتقال working إلى done عند الإيقاف، والوكيل الذي خرج اختفى، والوكيل الجديد مر بالحالة unknown لثوان ثم idle. والثاني أن الحالة blocked من OpenCode نفسه لم تظهر في تجربتنا، لأن الوكيل لم يصل أبداً إلى الخطوة التي يطلب فيها تشغيل الاختبارات، وهي الخطوة التي ضبطنا لها السؤال بالإعداد "bash": "ask". ولذلك رأينا blocked بالطريقتين الأخريين فقط: من سكربت يرسل تقريره على السيرفر الثاني، ومن سكربت OSC 7501 في herdr-core، وكلاهما في الأقسام التالية. أما قاعدة permission_required في ملف قواعد OpenCode فهي التي يفترض أن تكتشف سؤاله، ونصها كما رأيت يبحث عن «△ Permission required» في آخر الشاشة.
فإذا أردت أن تجرب الحالات الثلاث مع وكيل حقيقي بسرعة، فاستعمل نموذجاً أسرع أو وكيلاً على خدمة سحابية لمهمة صغيرة، وابدأ بوكيل واحد، ثم أضف الثاني عندما ترى أن الأول يتقدم. والوقت الذي ضاع هنا لم يضع بسبب herdr، وإنما بسبب ما شرحناه في مقال النموذج المحلي: طلب الوكيل الأول وحده آلاف الرموز، والمعالج دون بطاقة رسومية يقرؤها ببطء.
الانفصال والرجوع: الوكيل لا يعرف أنك ذهبت
ضغطنا ctrl+b q في xterm، وهو مفتاح الانفصال في herdr مثل tmux، فأغلقت النافذة، ثم سألنا عن العمليات والوكلاء:
== after ctrl+b q
no herdr client
154 /home/dev/.local/bin/herdr server
714 /home/dev/.local/bin/opencode serve --service
4111 opencode
4194 opencode
[{"name":"fixer","agent_status":"working"},{"name":"feature","agent_status":"done"}]
23.8 MB /home/dev/.local/bin/herdr serverفي المخرج أعلاه لاحظ التالي:
- لم يبق أي عميل
herdr، ولكن الخادمherdr serverيعمل، ومعه عمليتاopencode، والوكيل الأول ما زال working. - الخادم يأخذ 23.8 ميجابايت من الذاكرة RSS مع ثلاث مساحات وجهاز بعيد، وعند الرجوع أضاف العميل 14.1 ميجابايت أخرى، وهذا رقم صغير جداً مقارنة بالوكيل نفسه أو بالنموذج.
- الوثائق تقول إن الخادم يتجاهل إشارة SIGHUP منذ الإصدار 0.9.4 على Linux وmacOS، فإغلاق الـ Shell التي بدأته لا يوقفه، وإيقافه يكون بالأمر
herdr server stop.
ثم فتحنا xterm جديداً وكتبنا herdr، فرجعت نفس المساحات ونفس الشاشة، والوكيل في منتصف عمله:

ولاحظ تفصيلاً صغيراً في اللقطة: الدائرة أمام reading-time صارت فارغة بعد أن كانت ممتلئة، أي أن الحالة رجعت idle بدلاً من done. والوثائق تشرح ذلك في صفحة المفاهيم: كل عميل يتذكر ما رآه من الوكلاء الذين انتهوا، والحالتان idle وdone تعنيان أن الوكيل جاهز، والفرق أن done لم يره أحد بعد. فإذا كنت تعتمد على done لتعرف ما فاتك فلا تفتح عميلاً ثانياً قبل أن تراجع القائمة.
وماذا لو توقف الخادم نفسه، بإعادة تشغيل الجهاز مثلاً؟ هنا الجواب مختلف، وجدول صفحة حالة الجلسة والاستعادة واضح: الانفصال والرجوع يبقي العمليات كما هي، أما إعادة تشغيل الخادم فترجع التخطيط فقط، المساحات والألسنة والأجزاء ومجلداتها، وتبدأ في كل جزء Shell جديدة، ولا يرجع الحوار مع الوكيل إلا إذا كان له تكامل يرسل أمر الاستئناف، مثل claude --resume أو codex resume. ومحتوى الشاشة لا يرجع إلا إذا فعلت الخيار التجريبي pane_history، والوثائق تحذر أن هذا المحتوى قد يكون فيه أسرار، وهو مغلق افتراضياً لهذا السبب.
ماذا يحدث إذا شغلت الوكيل داخل tmux؟
كثير من المطورين يبدؤون tmux تلقائياً مع كل طرفية، فما الذي يحدث إذا فتحت جزءاً في herdr فبدأ tmux، وشغلت فيه الوكيل؟ جربنا ذلك بلسان جديد في المساحة الأولى، وشغلنا فيه tmux new-session -s inner opencode:
t=$(herdr tab create --workspace w1 --label tmux-test --no-focus)
p=$(echo "$t" | jq -r .result.root_pane.pane_id)
herdr pane run $p "tmux new-session -s inner opencode"
sleep 6
herdr pane get $p | jq -c ".result.pane|{pane_id,agent,agent_status}"
herdr agent list | jq -c "[.result.agents[]|{name,pane_id,agent_status}]"والمخرج سوف يكون كما يلي:
{"pane_id":"w1:p2","agent":null,"agent_status":"unknown"}
[{"name":"fixer","pane_id":"w2:p1","agent_status":"working"},{"name":"feature","pane_id":"w3:p1","agent_status":"working"}]
الوكيل يعمل كما ترى في اللقطة، ولكنه غير موجود في قائمة الوكلاء، والجزء نفسه agent: null. والسبب أن herdr يبحث عن عملية الوكيل في مقدمة الجزء، والعملية التي يجدها هي عميل tmux، أما OpenCode فيعمل تحت خادم tmux في مكان آخر. وصفحة الوكلاء في الوثائق تذكر هذا، وتقترح أن تعدل قاعدة بدء tmux التلقائي في ملف الـ Shell بحيث لا تعمل داخل herdr، بالشرط ${HERDR_ENV:-} != 1:
if [[ -z ${TMUX:-} && ${HERDR_ENV:-} != 1 ]]; then
tmux new-session -A -s my-session
fiأما العكس، أي أن تشغل herdr نفسه داخل tmux على سيرفر، فهو مسموح ويعمل، لأن الوكلاء في هذه الحالة داخل أجزاء herdr مباشرة.
جهاز آخر عبر SSH في نفس القائمة
الحاوية hrd-workbox تمثل سيرفراً، فيها خادم SSH ومفتاح الحاسوب في authorized_keys، وأضفنا لها اسماً في ~/.ssh/config. ثم كتبنا في جزء من herdr الأمر herdr machine add workbox، فسأل:
matching herdr 0.9.5 is not installed on workbox (session default) for linux-x86_64.
Install the current local herdr binary to "$HOME/.local/bin/herdr"? [Y/n] y
herdr: installed remote binary to ~/.local/bin/herdr, but the remote shell does not resolve `herdr` to that path
Saved SSH machine 5336eebe76b9459beda173d6530d29c6. Remote server is ready.
Open Herdr clients connect automatically.في المخرج أعلاه لاحظ التالي:
- herdr سأل قبل أن يثبت شيئاً على السيرفر، والوثائق تقول إن الاتصال في الخلفية لا يثبت ولا يحدث شيئاً أبداً، وإن الإجابة الافتراضية على إيقاف خادم قديم هي لا، لأن إيقافه يوقف وكلاءه.
- نسخ نفس الملف الثنائي من الحاسوب لأن النظام والمعالج متطابقان، ولو اختلفا لنزل الإصدار المناسب من herdr.dev.
- التحذير الثاني مهم:
~/.local/binليس فيPATHعلى السيرفر، فإذا دخلت بـ SSH وكتبتherdrفلن تجده، ولكن herdr نفسه يعرف المسار ويستعمله. - الحفظ لا يحتوي كلمات مرور ولا مفاتيح، فالمصادقة Authentication كلها لـ OpenSSH، كما تقول صفحة ربط الأجهزة.
وعلى السيرفر شغلنا وكيلاً من نوع آخر: سكربت Bash صغير يرسل حالته بنفسه بالطريقة الثانية، يعمل 30 ثانية ثم يسأل سؤالاً:
#!/usr/bin/env bash
report() { [ "${HERDR_ENV:-}" = 1 ] && "$HERDR_BIN_PATH" pane report-agent "$HERDR_PANE_ID" --source custom:nightly --agent nightly --state "$1" --seq "$(date +%s%N)" >/dev/null 2>&1; }
report working; echo "running the nightly checks..."; sleep 30
report blocked; read -r -p "push the report? [y/n] " answer
report working; echo "you said: $answer"; sleep 5
report idle; echo "finished"
"$HERDR_BIN_PATH" pane release-agent "$HERDR_PANE_ID" --source custom:nightly --agent nightly --seq "$(date +%s%N)" >/dev/null 2>&1وشغلناه من الحاسوب دون أن ندخل إلى السيرفر، بالخيار --machine:
w=$(herdr --machine workbox workspace create --cwd /home/dev --label nightly --no-focus)
p=$(echo "$w" | jq -r .result.root_pane.pane_id)
herdr --machine workbox pane run $p "./report-agent.sh"
sleep 4; herdr --machine workbox agent list | jq -c "[.result.agents[]|{name,pane_id,agent,agent_status}]"
sleep 30; herdr --machine workbox agent list | jq -c "[.result.agents[]|{pane_id,agent,agent_status}]"والمخرج سوف يكون كما يلي:
[{"name":null,"pane_id":"w2:p1","agent":"nightly","agent_status":"working"}]
[{"pane_id":"w2:p1","agent":"nightly","agent_status":"blocked"}]ولاحظ أن عنوان الجزء على السيرفر هو أيضاً w2:p1، مثل جزء الوكيل fixer على الحاسوب، لأن العناوين خاصة بكل خادم، ولذلك يحتاج كل أمر للسيرفر الخيار --machine workbox. والسكربت ليس من الوكلاء الذين يعرفهم herdr، ومع ذلك ظهر باسمه nightly وبحالته، لأنه أرسلها بنفسه، وظهر في نفس القائمة مع وكلاء الحاسوب تحت اسم الجهاز workbox كما رأيت في لقطة الألوان الثلاثة. وهذا هو الاستعمال الذي صممت له هذه الميزة: وكيل يعمل ساعات على سيرفر قوي أو آلة افتراضية VM، وأنت تراه من حاسوبك، وإذا نام الحاسوب بقي الوكيل يعمل هناك.
والآن ماذا يحدث إذا حاولنا أن نجيب عن سؤال الوكيل بالأمر herdr agent prompt الذي أرسلنا به المهام؟ جربنا ذلك، ثم أجبنا بالطريقة الصريحة: نكتب الحرف ثم Enter بأوامر الجزء:
herdr --machine workbox agent prompt w2:p1 "y"
herdr --machine workbox pane send-text w2:p1 y
herdr --machine workbox pane send-keys w2:p1 enter
sleep 2; herdr --machine workbox agent list | jq -c "[.result.agents[]|{pane_id,agent,agent_status}]"
sleep 6; herdr --machine workbox agent list | jq -c "[.result.agents[]|{pane_id,agent,agent_status}]"والمخرج سوف يكون كما يلي:
{"code":"agent_blocked","message":"agent w2:p1 is blocked and requires interactive input"}
[{"pane_id":"w2:p1","agent":"nightly","agent_status":"working"}]
[]في المخرج أعلاه لاحظ التالي:
- الأمر
agent promptرفض أن يكتب في وكيل حالته blocked، وهذا مقصود في التصميم كما في صفحة أتمتة الوكلاء: الرسالة العادية لا تجيب عن سؤال إذن، والإجابة تكون بقرار صريح منك بأوامر الجزء أو المفاتيح. - بعد الإجابة رجعت الحالة working، لأن السكربت أرسلها، ثم اختفى الوكيل من القائمة تماماً لأن السكربت أرسل
release-agentعند خروجه، فرجع الجزء طرفية عادية.
herdr-core والأمر hc: وكلاء يشغلون وكلاء
جربنا بعد ذلك herdr-core وحده، وهو الأساس الذي يقوم عليه التطبيق الجديد. والأمر hc run --bg يشغل برنامجاً في طرفية تبقى ويرجع فوراً، وhc ls يعرض الطرفيات الحية، وhc read يقرأ الشاشة دون اتصال بها. وبدلاً من الوكيل كتبنا سكربتاً يرسل حالته بالطريقة الثالثة، OSC 7501:
#!/usr/bin/env bash
status() { printf '\e]7501;state=%s:app=fake-agent\e\\' "$1"; }
status working; echo "working on the task..."; sleep 20
status blocked; read -r -p "apply the change? [y/n] " answer
status working; echo "you said: $answer"; sleep 5
status done; echo "finished"; sleep 600ثم شغلنا الاختبارات والسكربت:
hc server status
hc run --bg --name tests -- python3 -m unittest -v
hc run --bg --name fake /lab/fake-agent.sh
hc lsوالمخرج، مع حذف بعض الحقول، سوف يكون كما يلي:
{"core":{"id":"113c3ecb59c00f847ee5b5ae70ce5136","name":"laptop"},"finished":0,"live":0,"pid":4994,"uptime_ms":17,"version":"0.1.21"}
hc: no systemd user manager here: the core ends with whatever started it
{"address":"t1","agent":"python3","cwd":"/home/dev/work/textkit","name":"tests","state":"live","turn":0}
{"address":"t2","agent":"fake-agent.sh","cwd":"/home/dev/work/textkit","name":"fake","state":"live","turn":0}
{"hidden_finished":1,"terminals":[{"address":"t2","agent":"fake-agent","cwd":"/home/dev/work/textkit","name":"fake","state":"live","status":"working","turn":0}]}في المخرج أعلاه لاحظ التالي:
- السطر الثاني تحذير صريح: لا يوجد مدير مستخدم systemd في الحاوية، فخادم herdr-core يعيش ما دامت العملية التي بدأته تعيش. وعلى سيرفر حقيقي هذا يرتبط بما شرحناه في دليل tmux عن
KillUserProcesses، وملاحظات الإصدار 0.1.21 تقول إنhc machine addصار يحذرك إذا كان السيرفر يوقف برامجك عند خروجك ويعطيك الأمر الذي يصلح ذلك. - الاختبارات انتهت في أقل من ثانيتين فاختفت من القائمة، والحقل
hidden_finished: 1يقول إن هناك طرفية منتهية مخفية، وتراها بالأمرhc ls --all. - السكربت ظهر باسم
fake-agentوهو الاسم الذي أرسله فيapp=، وحالته working، أي أن herdr-core قرأ التسلسل الذي طبعه.
وبعد 20 ثانية صارت الحالة blocked، فحاولنا أن نجيب بالأمر hc send fake y، والمخرج سوف يكون كما يلي:
{"hidden_finished":1,"terminals":[{"address":"t2","agent":"fake-agent","cwd":"/home/dev/work/textkit","name":"fake","state":"live","status":"blocked","turn":1}]}
{"error":{"hint":"typing would answer its dialog; read its screen first (hc read t2), or --force","kind":"blocked","message":"t2 is blocked (waiting)"}}وهذه أفضل ميزة أمان رأيناها في التجربة: herdr-core رفض أن يكتب في برنامج ينتظر قراراً، والسبب أن الكتابة قد تجيب عن سؤال لم تقرأه، مثل «هل أحذف هذا المجلد؟». فإذا كنت متأكداً فأضف --force، وهذا ما فعلناه بعد أن قرأنا الشاشة:
== hc send fake y --force
{"started":true,"status":"blocked","turn":1}
{"hidden_finished":1,"terminals":[{"address":"t2","agent":"fake-agent","cwd":"/home/dev/work/textkit","name":"fake","state":"live","status":"done","turn":2}]}
working on the task...
apply the change? [y/n] y
you said: y
finishedوالحقل turn زاد من 1 إلى 2، فهو يعد الدورات التي يعمل فيها البرنامج ثم يتوقف. ثم جربنا شيئين آخرين في herdr-core. الأول: OpenCode نفسه دون أي تكامل، بالأمر hc run --bg --name oc opencode، فظهرت حالته idle والحقل reported: true، أي أن OpenCode 2.3.2 يرسل OSC 7501 بنفسه. والثاني: نفس السكربت السابق داخل tmux، بالأمر hc run --bg --name intmux -- tmux new-session -s t /lab/fake-agent.sh، فكان المخرج:
{"agent":"opencode","reported":true,"status":{"app":"opencode","state":"idle"}}
{"foreground":"tmux: client","reported":false,"status":null}أي أن tmux ابتلع التسلسل ولم يمرره، فلا حالة، وهذا هو نفس الحد الذي رأيناه في Herdr TUI بطريقة أخرى، والأسئلة الشائعة في الصفحة الرئيسية تذكره: الوكيل داخل tmux في herdr لا يستطيع أن يرسل حالته عبر tmux.
وأهم ما في herdr-core ليس ما جربناه، وإنما ما صمم له: أن يشغل وكيل وكيلاً آخر ويسمع منه. فالأمر hc run --bg --name review codex "review src/x.rs. Done: hc send $HC_TERMINAL_ID" من صفحة herdr-core يبدأ وكيل مراجعة تحت الوكيل الحالي، ويقول له أن يرسل تقريره عندما ينتهي، فيصل التقرير إلى مدخل الوكيل الأول، والأمر hc --skill يطبع للوكيل الدليل كاملاً في قراءة واحدة. وهذه الفكرة هي نفسها التي نشرحها في مقال الوكلاء الفرعيين Subagents، ولكن هنا عبر طرفيات حقيقية تراها وتتدخل فيها.
الحدود Limits: ما لا يفعله herdr
- الوكيل داخل tmux لا حالة له: رأيناه في الطريقتين، قراءة الشاشة وOSC 7501، فشغل الوكيل في جزء herdr مباشرة.
- الحالة تخمين لأغلب الوكلاء في Herdr TUI: القواعد تقرأ الشاشة، والسؤال الجديد الذي لم تتعلمه القواعد قد يظهر idle. استعمل
herdr agent explainعندما تشك، وثبت التكامل للوكيل الذي يدعمه. - الحالة لا تقول هل يتقدم الوكيل: working لمدة 47 دقيقة كانت صحيحة في تجربتنا، والوكيل لم يكتب سطراً واحداً.
- لا ترجع العمليات بعد إعادة الإقلاع: يرجع التخطيط، ويرجع الحوار فقط للوكلاء الذين لهم أمر استئناف، أما العمل الذي كان في منتصفه فيبدأ من جديد عندما تطلبه.
- البرنامجان لا يتشاركان: وكلاء Herdr TUI لا تظهر في التطبيق ولا في الجوال، فاختر واحداً لكل جهاز.
- herdr لا يعزل الوكيل: الوكيل يعمل بصلاحياتك كاملة، والـ Worktree تفصل الملفات لا الصلاحيات، والعزل الحقيقي يكون بصندوق معزول Sandbox كما شرحنا في مقال بيئة التشغيل Harness.
- التطبيق على Linux يحتاج Vulkan: على سيرفر دون شاشة استعمل herdr-core أو Herdr TUI.
الأمان والخصوصية
herdr يملك كل الطرفيات التي يعمل فيها وكلاؤك، فمن يصل إلى ملف الـ Socket الخاص به يستطيع أن يكتب في أي وكيل، وهو في ~/.config/herdr/herdr.sock كما ظهر في herdr status، فلا تغير صلاحياته. وهناك ثلاث نقاط تستحق أن تعرفها قبل أن تعتمده في العمل:
- قواعد الاكتشاف تأتي من الإنترنت: Herdr TUI ينزل ملفات القواعد من herdr.dev ويطبقها، وهي قواعد مطابقة نص لا كود يعمل، ولكن إذا كانت سياسة شركتك تمنع ذلك فأوقفه بالخيار
manifest_check = false. - الإضافات Mods في التطبيق كود موثوق: README التطبيق يقول إن الإضافات كود JavaScript غير معزول، فلا تثبت إضافة شخص آخر قبل أن تقرأها، وهذا ينطبق على الإضافات التي يكتبها وكيلك أيضاً.
- بيانات الاستعمال Telemetry في التطبيق مفعلة افتراضياً: كما يقول README التطبيق، وتغلقها من الإعدادات في قسم الخصوصية. أما الجوال فصفحته تقول إنه دون حساب ودون إعلانات أو تتبع، ويتصل بأجهزتك مباشرة عبر SSH.
herdr ومن يشبهه: مقارنة من الصفحات الرسمية
herdr ليس الأداة الوحيدة لهذه المشكلة، والصورة التالية تضعه بجانب ثلاث أدوات معروفة وبجانب tmux يدوياً، والمعلومات كلها من README كل مشروع وصفحاته الرسمية، وما لم تذكره الصفحة كتبناه «غير مذكور» بدلاً من أن نخمنه، ولم نشغل في المختبر إلا herdr:

Claude Squad
Claude Squad تطبيق طرفية يدير عدة وكلاء، منها Claude Code وCodex وGemini وAider، ويقول README إنه يقوم على ثلاثة أشياء: tmux لجلسة معزولة لكل وكيل، وGit Worktrees لفرع لكل جلسة، وواجهة TUI بسيطة. والأمر اسمه cs، وآخر إصدار 1.0.20 بتاريخ 20 أغسطس 2026، والترخيص AGPL-3.0، ويحتاج tmux وأداة gh مثبتين.
- نقاط القوة: يبني على tmux الذي تعرفه، فالجلسات تبقى بنفس طريقة tmux، وفيه عرض للفرق Diff قبل أن تدفع التغييرات، ووضع تجريبي
--autoyesيقبل الأسئلة تلقائياً. - نقاط الضعف: README لا يذكر عرض حالة كل وكيل في القائمة، والقبول التلقائي يتجاوز أسئلة الوكيل التي وضعت لحمايتك، وترخيص AGPL يحتاج انتباهاً إذا كنت ستعدله وتوزعه.
ccmanager
ccmanager تطبيق سطر أوامر يثبت من npm، يدير جلسات Claude Code وGemini CLI وCodex CLI وCursor Agent وCopilot CLI وCline CLI وOpenCode وKimi CLI عبر Git Worktrees ومشاريع متعددة، وآخر إصدار 4.4.11 بتاريخ 27 أكتوبر 2026، والترخيص MIT. ويعرض حالة كل جلسة بثلاث قيم: busy وwaiting وidle، بطريقة اكتشاف خاصة بكل وكيل يمكن تعديلها، ولا يحتاج tmux.
- نقاط القوة: إنشاء الـ Worktrees ودمجها وحذفها من داخله، ودعم ملف
.worktreeincludeلنسخ الملفات المتجاهلة مثل.envإلى كل Worktree جديدة، وخطافات Hooks عند تغير الحالة، وإعادة فتح الجلسات بعد إعادة التشغيل. - نقاط الضعف: الجلسات تعيش داخل عملية ccmanager نفسها عبر PTY كما يقول README، ولا يذكر خادماً منفصلاً يبقيها إذا أغلقت الطرفية، ولا يذكر أجهزة بعيدة غير Devcontainer.
Conductor
Conductor تطبيق سطح مكتب يشغل Claude Code وCodex وCursor وOpenCode بالتوازي، وكل مهمة لها مساحة عمل Workspace وفرع وWorktree وطرفية ومراجعة للفرق، وفيه سحابة Conductor Cloud تشغل الوكلاء في آلات افتراضية مصغرة microVMs. وصفحة التثبيت تقول إنه غير متاح على Windows ولا Linux بعد، والموقع يقول إنه انضم إلى Meta، وآخر إصدار في سجل التغييرات 0.97.0 بتاريخ 19 نوفمبر 2026.
- نقاط القوة: أكمل سير عمل من المهمة إلى طلب الدمج Pull Request، والـ Worktree لكل مساحة مدمجة في التصميم، ويعمل في السحابة إذا أردت أن تغلق الحاسوب.
- نقاط الضعف: macOS فقط على الجهاز، ويحتاج حساب GitHub ومزود وكيل، والأسئلة الشائعة فيه تقول إن الوكلاء يعملون على جهازك بصلاحياتك دون صندوق معزول، وإنه يضيف تعليمات نظام خاصة به للوكيل.
tmux يدوياً
وأخيراً الخيار الذي لا يحتاج أي أداة جديدة: Worktree بالأمر git worktree add، وجلسة tmux لكل وكيل، وسكربت صغير يعرض آخر سطر من كل جزء. وهذا يعمل، وقد تكون هذه طريقتك الآن، ونقطة قوته أنه لا يضيف شيئاً تحتاج أن تثق به أو تحدثه، ونقطة ضعفه أنك أنت الذي تكتشف الحالة، وأنك سوف تكتب بنفسك تدريجياً جزءاً مما تفعله هذه الأدوات.
والفرق الأهم بين herdr والبقية في رأينا شيئان: أنه يملك الطرفيات في خادم منفصل مثل tmux بدلاً من أن يبني على tmux أو يعيش داخل عملية واحدة، وأنه يجمع أجهزة متعددة في قائمة واحدة. والثمن أن عائلته منقسمة اليوم بين برنامجين لا يتشاركان، وأن الحالة لأغلب الوكلاء ما زالت تخميناً من الشاشة في Herdr TUI.
أخطاء شائعة
- تشغيل عدة وكلاء على نموذج محلي واحد بمعالج عادي: كل طلب يقطع ذاكرة الآخر المؤقتة، ورأينا طلباً واحداً يستغرق 47 دقيقة. شغل وكيلاً واحداً محلياً في الوقت نفسه، والسبب أن التوازي هنا يضاعف الوقت ولا يقسمه.
- ترك المهلة الافتراضية في الوكيل مع نموذج بطيء: OpenCode يقطع الطلب بعد خمس دقائق دون رد ويعيد المحاولة من البداية، فلا ينتهي شيء. ارفع
headerTimeoutأو أغلقه للنماذج المحلية البطيئة. - الوثوق بالحالة idle قبل أن تكتب في الوكيل: السؤال الذي لم تتعلمه القواعد يظهر idle، فاقرأ الشاشة أولاً أو استعمل الأوامر التي ترفض الكتابة في وكيل blocked مثل
hc send. - بدء tmux تلقائياً في ملف الـ Shell: كل جزء جديد في herdr يفتح tmux، فلا يرى herdr أي وكيل. أضف الشرط
HERDR_ENVإلى قاعدة البدء. - وكيلان في نفس المجلد: المدير لا يمنع أن يكتب وكيلان في نفس الملف، فاستعمل Worktree لكل مهمة من herdr أو من Git.
- تشغيل سكربت التثبيت دون قراءته: سطر
curl | shيشغل كوداً بصلاحياتك، فنزله واقرأه أولاً، وهو قصير في herdr. - توقع أن يرجع العمل بعد إعادة الإقلاع: الانفصال يبقي العمليات، وإعادة تشغيل الخادم لا تبقيها، فاحفظ عمل الوكيل في commits صغيرة كما شرحنا في مقال Git.
قائمة تحقق Checklist
- هل كل وكيل في Worktree وفرع خاص به؟
- هل الوكلاء في أجزاء herdr مباشرة وليس داخل tmux؟
- هل جربت
herdr agent explainعلى كل نوع وكيل تستعمله، ورأيت الحالات الثلاث مرة واحدة على الأقل؟ - هل ثبت التكامل للوكلاء الذين لهم تكامل، حتى يرجع الحوار بعد إعادة التشغيل؟
- هل عدد الوكلاء بالتوازي يتحمله النموذج، محلياً كان أو اشتراكاً بحدود استعمال؟
- هل السيرفر البعيد لا يوقف برامجك عند خروجك من SSH، أي أن
KillUserProcessesمغلق أو Linger مفعل؟ - إذا استعملت التطبيق: هل قررت بشأن بيانات الاستعمال، وهل قرأت كل إضافة قبل تثبيتها؟
- هل تعرف كيف توقف كل شيء:
herdr server stopوhc server stop؟
| الموقف | الأنسب | والسبب |
|---|---|---|
| وكيل واحد في الوقت نفسه | الطرفية العادية أو tmux | لا يوجد ما تتابعه غير شاشة واحدة |
| وكيلان أو ثلاثة على حاسوبك وسيرفر | Herdr TUI | حالة كل وكيل وأجهزة متعددة في قائمة واحدة |
| تريد أن ترى الوكلاء من الجوال | herdr-core مع التطبيق | الجوال يتصل بـ herdr-core فقط |
| فريق يعمل على macOS ويريد طلبات دمج جاهزة | Conductor | سير عمل كامل من المهمة إلى Pull Request |
| تعمل في tmux منذ سنوات ولا تريد أداة خادم جديدة | Claude Squad أو tmux يدوياً | يبني على جلسات tmux التي تعرفها |
| وكلاء على نموذج محلي دون بطاقة رسومية | وكيل واحد في الوقت نفسه | التوازي يضاعف الوقت على نفس المعالج |
تدريب عملي
- ثبت Herdr TUI، وافتح مساحة لمستودعك، واصنع منها Worktreeين بالأمر
herdr worktree create، وشغل وكيلك في كل واحدة، وسجل الحالات بسكربتwatch.shكما فعلنا. - اكتب سكربتاً صغيراً يرسل حالته بالأمر
herdr pane report-agent، مثل سكربت الاختبارات الليلية، وتأكد أنه يظهر باسمه في القائمة. - شغل وكيلك داخل tmux في جزء من herdr، وتأكد بنفسك أنه يختفي من القائمة، ثم أصلح قاعدة tmux في ملف الـ Shell.
حذف المختبر Cleanup
إذا جربت المختبر بنفسك فأوقف الخوادم ثم احذف الحاويات والشبكة والنموذج:
docker exec hrd-herdr bash -lc 'export PATH=$HOME/.local/bin:$PATH; herdr server stop; hc server stop'
docker rm -f hrd-herdr hrd-workbox hrd-ollama
docker network rm hrd-net
docker image rm hrd-lab:1الخلاصة
- تشغيل عدة وكلاء بالتوازي يحتاج شيئين: Worktree لكل مهمة حتى لا يكتب وكيل فوق آخر، ومكاناً واحداً يقول لك أي وكيل ينتظرك، وherdr يجمع الثاني مع طرفيات تبقى في خادم.
- herdr اليوم برنامجان لا يتشاركان: Herdr TUI في الطرفية، والجيل الجديد herdr-core مع تطبيق سطح المكتب والجوال.
- Herdr TUI يعرف الحالة بقراءة الشاشة بقواعد لكل وكيل أو بتقرير الوكيل نفسه، وherdr-core لا يقبل إلا ما يرسله البرنامج عبر OSC 7501، والوكيل داخل tmux لا حالة له في الاثنين.
- في المختبر رأينا working وdone وidle من وكيلي OpenCode، وblocked من سكربتين يرسلان حالتهما، ورجعنا بعد الانفصال إلى نفس الشاشة، وأضفنا سيرفراً عبر SSH في نفس القائمة، ورأينا herdr وherdr-core يرفضان الكتابة في برنامج ينتظر قراراً. أما الوكيل على النموذج المحلي فلم يكتب سطراً في ساعتين.
- الحالة تقول ماذا يعرض الوكيل لا هل يتقدم، والنموذج المحلي الواحد لا يخدم وكيلين بسرعة، فالتوازي له ثمن تدفعه في الحوسبة وفي انتباهك.
وفي المقال التالي من المسار بإذن الله نتحدث عن الوكلاء الفرعيين Subagents، أي أن يقسم وكيل واحد عمله بين وكلاء يعملون بالتوازي في فروع منفصلة:
سجل التحديثات
- 20 نوفمبر 2026: كتابة المقال وتشغيل المختبر بـ Herdr TUI 0.9.5 وherdr-core 0.1.21 وOpenCode 2.3.2 مع Ollama 0.40.13 ونموذج qwen3:4b-instruct على معالج دون بطاقة رسومية، وسيرفر ثان عبر SSH في Docker.