عن المشروع

Trail Boss هو موجه انتباه من لوحة واحدة للمطورين الذين يشغلون جلسات CLI تفاعلية متعددة لبرمجة الذكاء الاصطناعي في نوافذ tmux متوازية. بدلاً من التنقل عبر النوافذ للعثور على الجلسة التي تحتاج إلى إدخال، فإنه يحافظ على طابور FIFO للجلسات المتوقفة ويسمح لك بالانتقال إلى رأس الطابور بضغطة مفتاح. مسار الكشف الرئيسي هو Claude Code hooks: حيث تقوم أحداث Stop و PermissionRequest بإدراج الجلسة في الطابور، بينما يقوم UserPromptSubmit أو تقدم النص (transcript advancement) بإخراجها منه. يرسل نص باعث الـ hook الأحداث مع معرف TMUX_PANE الحالي إلى daemon يعمل بـ Bun + SQLite على localhost:4000. كما يوجد كاشف tmux احتياطي يقوم بفحص النوافذ المختارة بحثاً عن فترات السكون وأنماط المطالبات، مما يسمح باستخدامه مع أدوات البرمجة التي تفتقر إلى hooks؛ ويتطلب ذلك بادئة عنوان @tb- ويستخدم فترات فحص وعتبة سكون قابلة للتكوين. واجهة المستخدم هي TUI مبنية بـ Go Bubble Tea مع طابور مقسم وعرض تفصيلي، وتحديث تلقائي، وفترة تهدئة للتخطي (skip cooldown)، ومعاينة حية لـ tmux capture-pane. توفر مساعدات Shell اختصارات مفاتيح tmux للانتقال إلى الجلسة العالقة التالية، أو التخطي، أو فتح نافذة اختيار منبثقة، والعودة إلى لوحة التحكم. ويعرض جزء من شريط الحالة عدد الجلسات العالقة. بشكل افتراضي، لا يقوم البرنامج بسحب التركيز تلقائياً؛ ولكن تفعيل TRAILBOSS_AUTO_JUMP=1 يتيح التقدم التلقائي بعد حل الجلسة. إنه ليس مشغلاً للأسطول (fleet spawner) ولا يقوم بتشغيل الوكلاء أو ترحيل الإدخالات إليهم. بل يوجه الانتباه إلى الجلسة الحية حيث يتفاعل المستخدم مباشرة. تشمل المتطلبات Bun و tmux و Claude Code مع hooks للكشف الأساسي، و Go 1.24+ لبناء TUI. يذكر ملف README أن المراحل من 1 إلى 9 قد اكتملت، مع عمل كشف الـ hook، والبديل tmux، وترتيب FIFO، وفترة تهدئة التخطي، والمصالحة (reconcile)، وسجل الإصلاح الذاتي، وهو مرخص بموجب MIT.