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

agent-device Callstack का एक ओपन-सोर्स टूल है जो AI कोडिंग एजेंटों को चल रहे अनुप्रयोगों में लाइव फीडबैक लूप देता है। इसे CLI, एक अंतर्निहित stdio MCP सर्वर और एक टाइप्ड Node.js क्लाइंट के रूप में वितरित किया जाता है, जो सभी एक ही रनटाइम साझा करते हैं। समर्थित लक्ष्यों में iOS, Android और HarmonyOS सिमुलेटर, एमुलेटर और भौतिक डिवाइस, साथ ही tvOS, Android TV, Amazon Vega OS TV, वेब, macOS और Linux शामिल हैं। यह Claude Code, Codex, Cursor, Windsurf, Cline और Goose जैसे एजेंटों के साथ काम करता है, या AI SDK या Eve के साथ बनाए गए एजेंटों के नीचे रनटाइम के रूप में काम करता है। README में वर्णित मुख्य क्षमताएँ: - केवल स्क्रीनशॉट पर निर्भर रहने के बजाय एक्सेसिबिलिटी स्नैपशॉट, रेफ्स, सेलेक्टर और React Native कंपोनेंट ट्री के माध्यम से ऐप स्थिति का निरीक्षण करें। - दृश्यमान UI पर कार्य करें: टैप करना, दबाना, फ़ील्ड भरना, स्क्रॉल करना, जेस्चर, प्रतीक्षा करना, स्थिति की पुष्टि करना और अलर्ट संभालना। - स्क्रीनशॉट, वीडियो, लॉग, ट्रेस, नेटवर्क डेटा, प्रदर्शन नमूने, क्रैश विवरण और React प्रोफाइल के साथ विफलताओं का निदान करें। - चरणों को स्थानीय या CI उपयोग के लिए .ad स्क्रिप्ट के रूप में सहेजकर वर्कफ़्लो दोहराएं, वैकल्पिक रूप से सख्त Maestro YAML में निर्यात के साथ। स्थापना npm के माध्यम से है (Node.js 22.12+, या वेब स्वचालन के लिए 24+), इसके बाद सेटअप जांचने के लिए एक doctor कमांड है। सत्र कॉलर के git वर्कट्री तक सीमित हैं, और होस्ट-स्थानीय डिवाइस दावे समानांतर एजेंटों को एक-दूसरे के सिमुलेटर और एमुलेटर पर कब्जा करने से रोकते हैं। डिवाइस स्वामित्व का निरीक्षण किया जा सकता है और पुराने मालिकों को डेमॉन के बिना जारी किया जा सकता है। समान कमांड BrowserStack, AWS Device Farm और Limrun पर होस्ट किए गए डिवाइस चला सकते हैं। प्लेटफ़ॉर्म बैकएंड भिन्न हैं: iOS के लिए एक स्थानीय एक्सेसिबिलिटी ब्रिज और XCTest, Android के लिए ADB, HarmonyOS के लिए HDC और ArkUI uitest, Vega वर्चुअल डिवाइस के लिए Vega CLI/VDA, macOS पर एक स्थानीय सहायक, और Linux पर AT-SPI। समर्थन गहराई भिन्न होती है, और एक capabilities कमांड रिपोर्ट करता है कि प्रत्येक लक्ष्य क्या समर्थन करता है। परियोजना खुद को Appium, Detox और Maestro के पूरक के रूप में स्थापित करती है: उनका उपयोग टेस्ट सूट लिखने और बनाए रखने के लिए किया जाता है, जबकि agent-device एक एजेंट को रनटाइम पर ऐप स्थिति पढ़ने और कमांड चुनने देता है, वैकल्पिक रूप से रन को उन प्रारूपों में निर्यात करता है। यह MIT लाइसेंस प्राप्त है।