Herdr: معدد الإرسال الوكيل الذكي والمقيم في محطتك الطرفية

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

ما هو Herdr؟

Herdr هو وكيل معدد متقدم مصمم للبقاء حيًا داخل محطتك الطرفية. يوفر مساحات عمل منظمة، وعلامات تبويب، وأجزاء متعددة للعمل عليها. بخلاف أدوات الإدارة التقليدية، يدعم Herdr استخدام الماوس الأصلي، ويمنحك نظرة سريعة على حالة كل وكيل (محظور، يعمل، مكتمل، خامل). يستمر العملاء في العمل حتى بعد فصلهم وإعادة الاتصال، مما يضمن سير عمل غير منقطع. لا يعتمد على تطبيقات الواجهة الرسومية المعقدة أو Electron، بل يقدم تجربة محطة طرفية أصيلة وواضحة.

تثبيت Herdr

يمكن تثبيت Herdr بعدة طرق سهلة:

• باستخدام برنامج التثبيت السريع عبر الطرفية: curl -fsSL https://herdr.dev/install.sh | sh
• لمعاينة Windows (إصدار تجريبي): powershell -ExecutionPolicy Bypass -c irm https://herdr.dev/install.ps1 | iex
• باستخدام Homebrew أو Mise (مدير الحزم الخاص بك).
• تنزيل الإصدار الثنائي المستقر مباشرة لنظامي Linux/macOS من صفحة الإصدارات على GitHub. تظل ثنائيات Windows الأصلية مخصصة لإصدارات المعاينة فقط في الوقت الحالي.

بدء الاستخدام السريع

لبدء استخدام Herdr في دليلك الحالي، ما عليك سوى تشغيل الأمر herdr. سيقوم Herdr ببدء تشغيل خادم جلسة خلفية أو الاتصال به. إذا كانت الجلسة لا تحتوي على مساحات عمل، فسيقوم Herdr بفتح واحدة تلقائيًا. يمكنك بعد ذلك تشغيل وكيل في الجزء الرئيسي.

لإنشاء مساحة عمل أخرى، اضغط على ctrl+b ثم shift+n. لتقسيم الأجزاء، اضغط ctrl+b ثم v أو minus. لإنشاء علامة تبويب جديدة، استخدم ctrl+b ثم c. وللتنقل بين مساحات العمل، اضغط ctrl+b ثم w.

لفصل العميل، اضغط ctrl+b q. ستستمر عمليات الخادم والأجزاء في العمل. يمكنك إعادة الاتصال لاحقًا بفتح محطة طرفية أخرى وتشغيل herdr مرة أخرى.

المفاهيم الأساسية في Herdr

الخادم والعميل

بشكل افتراضي، يتصل أمر herdr بخادم خلفي. الفصل يغلق العميل فقط، بينما يوقف herdr server stop الخادم الافتراضي ويقتل جميع أجزائه. يمكن استخدام الجلسات المسماة (مثل herdr session attach work) لإنشاء مساحات عمل خادم منفصلة تمامًا.

مساحات العمل، علامات التبويب، والأجزاء

• مساحة العمل: هي حاوية على مستوى المشروع لتنظيم عملك.
• علامات التبويب: تجمع الأجزاء داخل مساحة العمل.
• الأجزاء: تمثل عمليات طرفية حقيقية، وليست مجرد تفسيرات للوكيل.

النسخ

يدعم Herdr النسخ باستخدام الماوس (السحب والتحديد، النقر المزدوج على الكلمات) أو لوحة المفاتيح. في وضع النسخ بلوحة المفاتيح (prefix+[)، يمكنك التنقل باستخدام h/j/k/l، w/b/e، و {/}، وبدء التحديد بـ v أو مسافة، والنسخ بـ y أو Enter، والخروج بـ q أو Esc.

التحديث والاستعادة

يقوم herdr update بتثبيت إصدار ثنائي جديد. لإيقاف الخادم القديم واستخدام الإصدار الجديد، يمكنك تشغيل herdr server stop ثم herdr مرة أخرى. يوفر الأمر herdr update –handoff التجريبي محاولة لنقل الأجزاء الحية بسلاسة من الخادم القديم إلى الجديد.

روابط المفاتيح (Keybindings)

يستخدم Herdr سلاسل ربط المفاتيح الصريحة. تعني prefix+n الضغط على البادئة المكونة (الافتراضي ctrl+b) ثم n. المفاتيح العادية القابلة للطباعة تتطلب البادئة لتجنب التعارض مع الكتابة العادية في الطرفية.

وعي الوكيل

يعرض الشريط الجانبي حالات الوكلاء المختلفة: 🔴 محظور (يحتاج إلى إدخال)، 🟡 يعمل (نشط)، 🔵 مكتمل (انتهى ولم يتم مراجعته)، 🟢 خامل (تم ورؤي). يعمل الكشف تلقائيًا من خلال قراءة العملية الأمامية والمخرجات الطرفية.

كيف يقارن Herdr؟

بينما يوفر tmux الثبات والأجزاء، فقد تم تطويره قبل ظهور مفهوم الوكلاء. من ناحية أخرى، تعرض أدوات إدارة الواجهة الرسومية حالة الوكيل ولكنها تتطلب منك مغادرة بيئة الطرفية الأصلية. Herdr يجمع بين المثابرة ووعي الوكيل في أداة واحدة تبقى دائمًا داخل محطتك الطرفية، مما يمنحك أفضل ما في العالمين دون التخلي عن تجربة الطرفية الأصيلة.

الوعي بالوكلاء والحالات

يُظهر الشريط الجانبي في Herdr بوضوح حالات الوكلاء المختلفة، مجمعة حسب مساحات العمل لتوفير نظرة عامة سريعة:

• 🔴 محظور: يشير إلى أن الوكيل ينتظر إدخالاً أو موافقة.
• 🟡 يعمل: يعني أن الوكيل يقوم بتنفيذ مهمة نشطة.
• 🔵 منتهي: يوضح أن العمل قد انتهى ولكن لم تتم مراجعته بعد.
• 🟢 عاطل: يدل على أن العمل قد انتهى وتم مراجعته.

يعمل هذا الكشف من خلال قراءة العملية الأمامية ومخرجات الطرفية، مع توفر تكاملات رسمية لوكلاء مثل Claude Code وCodex وGitHub Copilot CLI وDevin، مما يوفر هوية جلسة الاستعادة وتقارير حالة دلالية.

يعيش في محطتك الطرفية

Herdr ليس تطبيق واجهة رسومية، ولا لوحة تحكم ويب، ولا يعتمد على Electron. إنه يعمل بشكل طبيعي داخل أي محطة طرفية تستخدمها بالفعل. هو ثنائي واحد مبني بلغة Rust، خفيف الوزن وبدون تبعيات معقدة، ويمكنه العمل حتى داخل tmux كبيئة طرفية خارجية.

الميزات التي تحصل عليها

• مساحات العمل: منظمة حول مستودعات Git أو أسماء المجلدات، مع علامات تبويب وأجزاء خاصة بها.
• علامات التبويب: ميزة أساسية في Socket API وCLI.
• نسخ سهل الاستخدام: سحب النص المحدد بالماوس، النقر المزدوج على الرموز، أو استخدام وضع نسخ لوحة المفاتيح المتقدم.
• الإشعارات: أصوات وإشعارات منبثقة للأحداث الخلفية.
• 18 سمة مدمجة: تتضمن Catppuccin، Terminal، Tokyo Night، Groovebox، وغيرها الكثير.
• استمرارية الجلسة: تظل العمليات الجزئية حية بعد فصل العميل، مع استعادة الوكلاء وتشغيلهم مرة أخرى، بما في ذلك سجل الشاشة الحديث.

الوكلاء يمكنهم استخدام Herdr أيضاً

يتيح مقبس Unix المحلي للوكلاء إمكانية إنشاء مساحات عمل، وتقسيم الأجزاء أو تكبيرها/تصغيرها، وإنشاء أدوات مساعدة، وقراءة المخرجات، وانتظار تغييرات الحالة. ابدأ باستخدام مستندات Socket API و ملف SKILL.md للحصول على تفاصيل.

الوكلاء المدعومون

يعمل الكشف التلقائي عن الوكلاء ‘خارج الصندوق’ بناءً على مطابقة أسماء العمليات واستنتاج مخرجات الطرفية. تشمل قائمة الوكلاء المدعومين:

• Pi
• Claude Code
• Codex
• Droid
• Amp
• OpenCode
• Grok CLI
• Hermes Agent
• Kilo Code CLI
• Devin CLI
• Cursor Agent
• AntiGravity CLI
• Kimi Code CLI
• GitHub Copilot CLI
• QoderCLI
• Kiro CLI

بالنسبة للوكلاء غير المدرجين، لا يزال Herdr يعمل كمضاعف طرفي مع مساحات العمل والأجزاء والتقسيم. يمكن لعمليات التكامل المخصصة الإبلاغ عن تسميات الوكيل عبر Socket API.

عمليات التكامل المباشر

تقدم عمليات التكامل الرسمية ميزات مثل هوية الجلسة الأصلية للاستعادة. يمكن تثبيتها باستخدام الأمر herdr integration install <اسم_التكامل>. على سبيل المثال: herdr integration install pi أو herdr integration install claude.

روابط المفاتيح الافتراضية

اضغط ctrl+b للدخول إلى وضع البادئة. إليك بعض الإجراءات الافتراضية الشائعة:

• prefix+c: علامة تبويب جديدة.
• prefix+n / prefix+p: علامة التبويب التالية / السابقة.
• prefix+1..9: التبديل بين علامات التبويب.
• prefix+w: التنقل في مساحة العمل.
• prefix+shift+n: مساحة عمل جديدة.
• prefix+v / prefix+minus: تقسيم الجزء.
• prefix+x: إغلاق الجزء.
• prefix+q: فصل العميل.

يتم دعم الماوس بشكل كامل. يمكن الاطلاع على بناء الجملة الكامل والإجراءات الاختيارية في وثائق التكوين.

التكوين

يقع ملف التكوين الرئيسي لـ Herdr في ~/.config/herdr/config.toml. يمكنك عرض التكوين الافتراضي الكامل باستخدام الأمر herdr –default-config. تغطي الإعدادات داخل التطبيق تفضيلات السمة والصوت والإشعارات. يتم الاحتفاظ بسجلات Herdr تحت ~/.config/herdr/، مع ملفي herdr-client.log و herdr-server.log الأكثر فائدة.

المستندات

للحصول على معلومات مفصلة حول Herdr، يمكنك الرجوع إلى المستندات الرسمية التي تغطي مجموعة واسعة من المواضيع:

• بدء الاستخدام السريع: الجلسة الأولى، الأجزاء، النسخ، الجلسات المسماة.
• التثبيت: التحديث، Homebrew، mise، Nix.
• حالة الجلسة: الفصل، استعادة إعادة التشغيل، استعادة الوكيل، التسليم المباشر.
• التكوين: روابط المفاتيح، السمات، الإشعارات، متغيرات البيئة.
• عمليات التكامل: Pi، OMP، Claude Code، Codex، Cursor Agent CLI، GitHub Copilot CLI، Droid، Kimi Code CLI، Opencode، Kilo Code CLI، Hermes، QoderCLI.
• SKILL.md: مهارة الوكيل القابلة لإعادة الاستخدام.
• Socket API: بروتوكول المقبس ومرجع CLI.

التطوير والرعاية والترخيص

تم بناء Herdr بدوام كامل، وهو مشروع مفتوح المصدر. يتم تمويل تطويره واستقراره من خلال الرعاية المباشرة. Herdr مرخص ترخيصًا مزدوجًا: مفتوح المصدر بموجب GNU Affero General Public License الإصدار 3.0 أو الأحدث (AGPL-3.0 أو الأحدث)، وتراخيص تجارية متاحة للمؤسسات التي لا يمكنها الالتزام بـ AGPL. للمزيد من التفاصيل، يمكن التواصل عبر hey@herdr.dev.

بفضل تصميمه الذكي وميزاته الغنية، يقدم Herdr حلاً متكاملاً للمطورين الذين يسعون لتعزيز إنتاجيتهم وتجربتهم في بيئة الطرفية، مع الحفاظ على المرونة والتحكم الكامل.