عن المشروع

agent-runner هي أداة إشراف للحفاظ على تشغيل واجهات البرمجة الذاتية بشكل مستمر. تعيد تشغيل عمليات الوكيل بعد كل جولة وتوفر إعدادات جاهزة لـ Claude Code وaider وgemini وcodewhale وkimi وpi، مع دعم أي واجهة برمجة تعتمد على وسائط الأوامر من خلال إعدادات مخصصة. الأداة منظمة حول نموذج من ثلاث طبقات: الجولة (استدعاء وكيل واحد)، والحلقة (حلقة إعادة تشغيل تلتقط الإشارات)، والشاهد (مراقب يضم 14 كاشفًا وإيقافًا تلقائيًا). توفر 15 دفاعًا مسمى منظمًا كبيانات، بما في ذلك ميزانيات زمنية للجولات، وعزل مجموعات العمليات، وتماثل مخبأ الأيتام، ومخابئ مقفلة بـ SHA، وتصنيف فرق المجموعات، وفحوصات دخانية عند بدء التشغيل. يوثق كل دفاع الحادثة التاريخية التي يعالجها وله اختبار ثابت. يشغل مكوّن المراقبة 14 كاشفًا على سجلات المشروع الخاضع للإشراف المحلية، ويغطي مشكلات مثل معدلات انتهاء المهلة، والجولات المعلقة، وسلاسل الأيتام، وتحذيرات القرص ونموه، وضغط الذاكرة، وفشل الشبكة، وتقييد المعدل، والتكرارات الشاذة. يمكن لكاشفين إيقاف الخدمة تلقائيًا عندما يكون الاستمرار ضارًا: فشل OAuth الذي يستهلك حصة API وحالات القرص الحرجة. يمكن لمكبح اختياري ناعم أن يحد من استخدام الذاكرة تحت ضغط مستمر. يعرض agent-runner 17 فعل أمر لإدارة دورة الحياة (init وinstall وstart وstop وrestart وkill وupgrade وmigrate) والملاحظة (peek وwatch وmonitor وevents وstatus وdoctor). يدعم وحدات مستخدم systemd لعمليتي serve وmonitor، ونوافذ تشغيل/إيقاف مجدولة، ومخرجات JSON للمستهلكين النهائيين، وترحيل الأحداث عن بُعد عبر اتصالات SSH مُدارة مع إبقاء الكشف على المضيف. يتضمن المشروع توثيقًا موسعًا يغطي البداية السريعة، ومرجع الأوامر، ومخطط الإعدادات، واستكشاف أخطاء المشغل، والبنية. وهو متوافق مع POSIX فقط (Linux وmacOS)، ومختبر مع Python 3.11+ على x86_64 وaarch64، ومرخص بموجب Apache 2.0.