عن المشروع

amux هي منصة تحكم مفتوحة المصدر مصممة لتنسيق وكلاء البرمجة بالذكاء الاصطناعي (مثل Claude Code، Codex، Gemini CLI، OpenCode، وOllama) من خلال لوحة تحكم ويب واحدة أو تطبيق جوال. تعتمد على التشغيل المحلي أولاً، والاستضافة الذاتية، وتُبنى كملف تنفيذي واحد بلغة Rust مع تخزين SQLite. الميزات الرئيسية تشمل: - المهام الذرية: لوحة كانبان مشتركة تستخدم آلية compare-and-swap لمنع تكرار العمل؛ تتطلب المهام أدلة للإشارة إلى الإنجاز وتحقق الأقران للتأكيد. - وعي العمال: يمكن للعمال رؤية حالة الأسطول، والاطلاع على أطراف زملائهم، والتنسيق عبر رسائل بين العمال تحمل طابع الأصل. - التوجيه: يمكن للمستخدمين الكتابة في الجلسات قيد التشغيل من اللوحة أو الهاتف لإعادة توجيه المهام أثناء التنفيذ. - الجداول والحلقات: مطالبات متكررة بنمط cron وحلقات ذاتية التشغيل للجولات الليلية المستقلة. - المجموعات والنطاق: يمكن تنظيم العمال في مسارات ذاكرة وبيئة وبوابات مشتركة. - تبديل النماذج: استبدال النماذج أو مزودي الخدمة للعمال قيد التشغيل دون فقدان السياق. - سجل الرسائل: يتم تسجيل جميع المطالبات والردود والتسليمات للاسترجاع لاحقاً. - الشفاء الذاتي: يقوم حارس المراقبة بالضغط التلقائي، وإعادة تشغيل الجلسات المتعطلة، وإعادة تشغيل آخر رسالة. التثبيت بسيط باستخدام مثبت بأمر واحد يهيئ الخادم وواجهة سطر الأوامر والخدمات النظامية (launchd على macOS، systemd على Linux). تُدمج لوحة التحكم في ملف خادم amux الثنائي، وتوفر واجهة سطر الأوامر (`amux-rs`) أوامر لإدارة اللوحة والتحكم في العمال والجداول الزمنية. تتكون البنية المعمارية من أربع علب برمجية بلغة Rust: الخادم، ولوحة التحكم، وواجهة سطر الأوامر، وأنواع المجال الأساسية. تستخدم ثماني بدائيات (اللوحة، العمال، المجولون، نظام الملفات، المجموعات، الذكريات، البيئة، الرسائل) لتكوين قدرات جديدة. ميزة بارزة هي ملفات `.mdai`، وهي ملفات Markdown محسوبة تعمل كعقد في رسم بياني موجه غير دوري (DAG)، تقوم بتوليف المحتوى من مصادر متصلة عبر مطالبات النموذج. يتيح ذلك إنشاء مستندات ديناميكية مع كشف الدورات والتخزين المؤقت. الأمان يعتمد على التشغيل المحلي أولاً مع مصادقة رمز الحامل، ويؤكد المشروع على عدم تعريض منفذ الخادم للإنترنت، وينصح باستخدام Tailscale للوصول عن بُعد. المرخصة تحت رخصة MIT + Commons Clause، مجانية للاستخدام والاستضافة الذاتية، مع اشتراط ترخيص منفصل لإعادة البيع التجاري. يجري تطويرها بنشاط مع خارطة طريق لتصبح نظام تشغيل دائم حول الوكلاء.