इस प्रोजेक्ट के बारे में

agent-runner स्वायत्त कोडिंग CLI को लगातार चालू रखने के लिए एक सुपरविज़न टूल है। यह प्रत्येक राउंड के बाद एजेंट प्रक्रियाओं को पुनः आरंभ करता है और Claude Code, aider, gemini, codewhale, kimi, और pi के लिए प्रीसेट प्रदान करता है, साथ ही कस्टम कॉन्फ़िगरेशन के माध्यम से किसी भी प्रॉम्प्ट-आर्ग्युमेंट CLI का समर्थन करता है। यह टूल तीन-स्तरीय मॉडल के आसपास व्यवस्थित है: राउंड (एक एजेंट आह्वान), लूप (सिग्नल-ट्रैपिंग रीस्टार्ट लूप), और विटनेस (14 डिटेक्टर और ऑटो-स्टॉप वाला मॉनिटर)। यह डेटा के रूप में संरचित 15 नामित सुरक्षा उपाय प्रदान करता है, जिनमें राउंड समय बजट, प्रोसेस ग्रुप आइसोलेशन, ऑर्फ़न स्टैश आइडेम्पोटेंसी, SHA-लॉक्ड स्टैश, सेट-डिफ़ वर्गीकरण, और स्टार्टअप स्मोक चेक शामिल हैं। प्रत्येक सुरक्षा उस ऐतिहासिक घटना का दस्तावेजीकरण करती है जिसे वह संबोधित करती है और उसका एक इनवेरिएंट परीक्षण होता है। मॉनिटर घटक पर्यवेक्षित प्रोजेक्ट के स्थानीय लॉग के विरुद्ध 14 डिटेक्टर चलाता है, जो टाइमआउट दर, हैंग राउंड, ऑर्फ़न चेन, डिस्क चेतावनियाँ और वृद्धि, मेमोरी दबाव, नेटवर्क विफलताएँ, दर सीमा, और दोहराव वाली विसंगतियों जैसे मुद्दों को कवर करते हैं। दो डिटेक्टर तब सेवा को स्वतः रोक सकते हैं जब जारी रखना हानिकारक हो: 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) है, x86_64 और aarch64 पर Python 3.11+ के साथ परीक्षण किया गया है, और Apache 2.0 के तहत लाइसेंस प्राप्त है।