منصوبے کے بارے میں

agent-runner خود مختار کوڈنگ CLIs کو مسلسل چلانے کے لیے ایک نگرانی کا ٹول ہے۔ یہ ہر راؤنڈ کے بعد ایجنٹ پروسیسز کو دوبارہ شروع کرتا ہے اور Claude Code، aider، gemini، codewhale، kimi، اور pi کے لیے پری سیٹس فراہم کرتا ہے، جبکہ حسب ضرورت کنفیگریشن کے ذریعے کسی بھی prompt-argument CLI کو سپورٹ کرتا ہے۔ یہ ٹول تین سطحی ماڈل کے گرد منظم ہے: راؤنڈ (ایک ایجنٹ کی درخواست)، لوپ (سگنل ٹریپنگ ری اسٹارٹ لوپ)، اور وٹنس (14 ڈیٹیکٹرز اور آٹو اسٹاپ کے ساتھ ایک مانیٹر)۔ یہ 15 نامزد دفاع فراہم کرتا ہے جو ڈیٹا کے طور پر تشکیل دیے گئے ہیں، جن میں راؤنڈ ٹائم بجٹ، پروسیس گروپ آئسولیشن، orphan stash idempotency، SHA-locked stashes، set-diff درجہ بندی، اور اسٹارٹ اپ اسموک چیکس شامل ہیں۔ ہر دفاع اس تاریخی واقعے کو دستاویز کرتا ہے جس کا وہ حل پیش کرتا ہے اور اس کا ایک invariant ٹیسٹ ہوتا ہے۔ مانیٹر جزو زیر نگرانی پروجیکٹ کی مقامی لاگز کے خلاف 14 ڈیٹیکٹرز چلاتا ہے، جن میں ٹائم آؤٹ کی شرح، معلق راؤنڈز، orphan chains، ڈسک وارننگز اور نمو، میموری پریشر، نیٹ ورک کی ناکامیاں، ریٹ لمیٹنگ، اور بار بار آنے والی بے ضابطگیاں شامل ہیں۔ دو ڈیٹیکٹرز سروس کو خود بخود روک سکتے ہیں جب جاری رکھنا نقصان دہ ہو: OAuth کی ناکامیاں جو API کوٹہ جلاتی ہیں اور ڈسک کی سنگین صورتحال۔ ایک اختیاری سافٹ بریک مستقل دباؤ کے تحت میموری کے استعمال کو محدود کر سکتا ہے۔ agent-runner لائف سائیکل مینجمنٹ (init، install، start، stop، restart، kill، upgrade، migrate) اور مشاہدے (peek، watch، monitor، events، status، doctor) کے لیے 17 کمانڈ وربز پیش کرتا ہے۔ یہ serve اور monitor پروسیسز کے لیے systemd یوزر یونٹس، شیڈولڈ run/pause ونڈوز، ڈاؤن اسٹریم صارفین کے لیے JSON آؤٹ پٹ، اور منظم SSH کنکشنز پر ریموٹ ایونٹ ریلے کی حمایت کرتا ہے جبکہ ڈیٹیکشن ہوسٹ پر رہتا ہے۔ اس پروجیکٹ میں وسیع دستاویزات شامل ہیں جن میں کوئیک اسٹارٹ، کمانڈ ریفرنس، کنفیگریشن اسکیما، آپریٹر ٹربل شوٹنگ، اور آرکیٹیکچر شامل ہیں۔ یہ صرف POSIX (Linux، macOS) ہے، Python 3.11+ کے ساتھ x86_64 اور aarch64 پر ٹیسٹ کیا گیا ہے، اور Apache 2.0 کے تحت لائسنس یافتہ ہے۔