agenteye) आपके AgentEye परिनियोजन के लिए एक टर्मिनल क्लाइंट है। यह आपके डेटा (सेशन, ईवेंट लॉग, मूल्यांकन) को क्वेरी करता है और संगठन का प्रबंधन करता है (API कुंजियाँ, उपयोगकर्ता, सेटिंग्स, अलर्ट, घटनाएं, सहेजी गई क्वेरीज़) — सब कुछ जो डैशबोर्ड करता है, एक स्क्रिप्ट या कोडिंग एजेंट से। हर कमांड --json फ़्लैग को सपोर्ट करता है, इसलिए यह एक प्रॉम्प्ट पर मनुष्य के लिए या कोडिंग एजेंट (Claude Code, Cursor) के लिए समान रूप से अच्छी तरह काम करता है।
यहagenteyeCLI है, कलेक्टर डेमॉन (agenteye-collector) से एक अलग टूल है। CLI आपके डैशबोर्ड से बात करता है; कलेक्टर सर्वर को ईवेंट भेजता है। कलेक्टर के लिए कलेक्टर इंस्टॉलेशन देखें।
इंस्टॉलेशन
CLI को सार्वजनिक PyPI परagenteye के रूप में प्रकाशित किया जाता है। क्योंकि AgentEye Python SDK भी agenteye वितरण नाम का उपयोग करता है, CLI को एक अलग वातावरण (pipx या uv tool) में इंस्टॉल करें ताकि दोनों कभी एक virtualenv में टकराएं नहीं:
pip install agenteye भी काम करता है यदि आप Python SDK को एक ही वातावरण में इंस्टॉल नहीं कर रहे हैं। CLI को Python 3.10+ की आवश्यकता है और GitHub टोकन की आवश्यकता नहीं है; यह एक सार्वजनिक पैकेज है।
इंस्टॉल की गई कमांड agenteye है:
प्रमाणीकरण
CLI डैशबोर्ड के साथ एक ईमेल किए गए एकबारी कोड के साथ प्रमाणित होता है:~/.agenteye/cli.json में संग्रहीत किया जाता है (केवल आपके द्वारा पठनीय, मोड 0600) और डिफ़ॉल्ट रूप से 24 घंटे के लिए वैध है। जब यह समाप्त हो जाता है, agenteye login फिर से चलाएं।
whoami कभी भी एक लापता या समाप्त सेशन पर त्रुटि नहीं देता — इसके बजाय logged_in: false की रिपोर्ट करता है, इसलिए एक स्क्रिप्ट या एजेंट सुरक्षित रूप से प्रमाणीकरण स्थिति को जांच सकता है (यदि कोई आधार URL सेट नहीं है या डैशबोर्ड अप्राप्य है तो यह अभी भी गैर-शून्य बाहर निकल सकता है)।
आवश्यकताएं: आपके ईमेल को डैशबोर्ड में साइन इन करने की अनुमति दी जानी चाहिए (अपने AgentEye प्रशासक से पूछें), और डैशबोर्ड को अपने आधार URL पर पहुंचा जा सकता होना चाहिए (देखें कॉन्फ़िगरेशन)। यदि आप एक कोड का अनुरोध करते हैं और कोई नहीं आता है, तो आपका ईमेल शायद अभी तक डैशबोर्ड एक्सेस के लिए सक्षम नहीं है।
अपने संगठन को चुनना (मल्टी-टेनेंट)
यदि आपका खाता एक से अधिक संगठन से संबंधित है, तो लॉगिन पर सक्रिय एक चुनें — इसे सहेजा जाता है और हर बाद की कमांड के लिए उपयोग किया जाता है:--org को पूरी तरह से अनदेखा कर सकते हैं। यदि आप कई से संबंधित हैं और एक को नहीं चुनते हैं, तो CLI उन्हें सूचीबद्ध करता है और आपको --org <slug> के साथ फिर से चलाने के लिए कहता है। सक्रिय संगठन हर अनुरोध पर डैशबोर्ड को भेजा जाता है, और आपकी अनुमतियां प्रति संगठन में हल की जाती हैं — agenteye whoami सक्रिय संगठन, इसमें आपकी अनुमतियां, और आपकी सभी सदस्यताएं दिखाता है।
कॉन्फ़िगरेशन
| सेटिंग | फ़्लैग | पर्यावरण चर | डिफ़ॉल्ट |
|---|---|---|---|
| डैशबोर्ड आधार URL | --base-url | AGENTEYE_DASHBOARD_URL | आवश्यक (कोई डिफ़ॉल्ट नहीं) |
| सक्रिय संगठन/टेनेंट | --org | AGENTEYE_ORG | लॉगिन पर चुना गया; ~/.agenteye/cli.json में सहेजा गया |
| सेशन टोकन | --token | AGENTEYE_CLI_TOKEN | ~/.agenteye/cli.json से |
| JSON आउटपुट | --json | AGENTEYE_CLI_JSON | बंद |
| TLS सत्यापन छोड़ें | --insecure / --secure | AGENTEYE_INSECURE | बंद (लॉगिन पर सहेजा गया) |
| अनुरोध टाइमआउट (सेकंड) | --timeout | — | 30 |
| उपयोग टेलीमेट्री अक्षम करें | (कोई नहीं) | AGENTEYE_ANALYTICS_DISABLED (या DO_NOT_TRACK) | बंद (टेलीमेट्री चालू) |
--base-url https://agenteye.example.com) या एक बार वातावरण के माध्यम से (यह आपके पहले login के बाद भी सहेजा जाता है):
AGENTEYE_HOME का सम्मान करती है (SDK और कलेक्टर द्वारा उपयोग की जाने वाली एक ही परंपरा); यदि सेट किया गया है, तो cli.json $AGENTEYE_HOME/cli.json में रहता है।
स्व-हस्ताक्षरित या आंतरिक TLS
यदि आपका डैशबोर्ड एक स्व-हस्ताक्षरित या आंतरिक प्रमाणपत्र के साथ HTTPS पर परोसा जाता है (उदाहरण के लिए, एक कच्चा लोड-बैलेंसर होस्टनाम), TLS सत्यापन इसे एकCERTIFICATE_VERIFY_FAILED त्रुटि के साथ अस्वीकार करता है। प्रमाणपत्र सत्यापन को छोड़ने के लिए --insecure पास करें:
--insecure आपके लॉगिन के समय cli.json में सहेजा जाता है, इसलिए बाद की कमांड स्वचालित रूप से सत्यापन छोड़ देती हैं; आपको फ़्लैग को दोहराना नहीं पड़ता। एक एकबारी सत्यापित कॉल के लिए --secure पास करें, या अपने अगले लॉगिन पर सत्यापन वापस चालू करने के लिए। CLI एक चेतावनी को stderr पर प्रिंट करता है किसी भी कमांड से पहले जो डैशबोर्ड से संपर्क करता है जबकि सत्यापन अक्षम है। सत्यापन को छोड़ना मैन-इन-द-मिडिल हमलों से सुरक्षा को हटाता है; अपने डैशबोर्ड के लिए नेटवर्क पाथ पर भरोसा करने से पहले सुनिश्चित करें कि आप इस पर भरोसा करते हैं (VPN, निजी सबनेट, आदि)।
टेलीमेट्री और गोपनीयता
CLI अनाम उपयोग विश्लेषण को Exosphere की विश्लेषण सेवा (PostHog) में भेजता है: कौन सी कमांड चलाई जाती हैं (उदाहरण के लिएsessions, keys create), क्या वे सफल हुईं, और वे कितने समय तक चलीं। यह उपयोग संकेत सूचित करता है कि कौन से फीचर को प्राथमिकता दी जाए।
- कोई एजेंट, सेशन, या ईवेंट डेटा कभी भी आपके बुनियादी ढांचे को नहीं छोड़ता है। केवल CLI उपयोग की रिपोर्ट की जाती है: कमांड और सबकमांड नाम (उदाहरण के लिए
keys create), आपके द्वारा उपयोग किए गए फ़्लैग के नाम (कभी भी उनके मान नहीं), सफलता/निकास स्थिति, और अवधि — साथ ही म्यूटेशन के लिए एक प्रति-कार्रवाई ईवेंट (उदाहरण के लिएapi_key_created,query_run) केवल स्थैतिक नाम/एनम और मोटे गिनती ले जाते हुए। आपका डैशबोर्ड URL, सेशन टोकन, ईमेल, संगठन स्लग, संसाधन ids, SQL, कुंजी रहस्य, और क्वेरी फ़िल्टर कभी नहीं भेजे जाते हैं। ऑपरेटरों को केवल एक अपारदर्शी आंतरिक id द्वारा पहचाना जाता है, कभी भी ईमेल द्वारा नहीं। - टेलीमेट्री डिफ़ॉल्ट रूप से सक्षम है। इसे बंद करने के लिए, CLI के वातावरण में
AGENTEYE_ANALYTICS_DISABLED=1सेट करें (CLI क्रॉस-टूलDO_NOT_TRACK=1परंपरा का भी सम्मान करता है)। - CLI सीधे PostHog (
https://us.i.posthog.com) को भेजता है। CLI चलाने वाली मशीन को उस होस्ट तक आउटबाउंड एक्सेस की आवश्यकता है; यदि यह अवरुद्ध है, तो टेलीमेट्री चुप रहता है (भेजना समय-सीमित है इसलिए यह कभी भी एक कमांड को विलंबित या तोड़ता नहीं है) और CLI अप्रभावित है।
वैश्विक विकल्प और सम्मेलन
यह एक बार पढ़ें; यह हर कमांड पर लागू होता है।- वैश्विक विकल्प कमांड से पहले जाते हैं।
agenteye --json sessionsसही है;agenteye sessions --jsonएक उपयोग त्रुटि है। ग्लोबल--json,--base-url,--org,--token,--insecure/--secure,--timeout,--quiet, और--no-colorहैं। --jsonशुद्ध JSON को stdout में, और कुछ नहीं प्रिंट करता है। मानव स्थिति लाइनें, चेतावनियां, और त्रुटियां stderr पर जाती हैं, इसलिए एक--jsonstdout कैप्चरjqमें पाइप करने के लिए स्वच्छ रहता है भले ही एक स्थिति पंक्ति दिखाई जाए।--jsonके बिना आप मानव आंखों के लिए एक बॉक्सित, रंगीन दृश्य प्राप्त करते हैं।--helpके साथ खोजें। हर कमांड और सबकमांड के पास--helpहै (और-hउपनाम):agenteye -h,agenteye sessions -h,agenteye keys create -h। शीर्ष-स्तरीय सहायता भी निकास कोड और वैश्विक विकल्प सूचीबद्ध करता है। कोई वैश्विक मशीन-पठनीय सतह डंप नहीं है; प्रति-कमांड--helpका उपयोग करें, साथ ही डोमेन-विशिष्टagenteye query schemaऔरagenteye settings schemaउन दोनों रजिस्ट्रीज के लिए।- पुष्टिकरण स्क्रिप्ट और एजेंटों के लिए स्वचालित रूप से छोड़ते हैं। बनाएं/अपडेट/हटाएं कमांड एक इंटरैक्टिव टर्मिनल में “क्या आप सुनिश्चित हैं?” के लिए प्रॉम्प्ट करते हैं, लेकिन
--jsonके तहत या जब भी stdin एक TTY नहीं है तो स्वचालित रूप से छोड़ देते हैं — इसलिए स्क्रिप्ट और एजेंट कभी लटकते नहीं हैं। इसे स्पष्ट रूप से छोड़ने के लिए--yes/-yपास करें। क्योंकि प्रॉम्प्ट एक एजेंट के लिए फायर नहीं करेगा, एक एजेंट को विनाशकारी क्रियाओं की पुष्टि पहले मानव के साथ करनी चाहिए। - पेजिनेशन: परिणाम नवीनतम-पहले और कर्सर-पेजिनेटेड हैं।
--limit N(उपनाम-n) पंक्तियों को कैप करता है और डिफ़ॉल्ट 50 है;--allस्वचालित रूप से पेजिनेट करता है (200-पंक्ति चंकों में)--limitतक — इसलिए एक नंगा--allअभी भी 50 पर रुकता है। एक पूर्ण स्वीप के लिए एक उच्च स्पष्ट टोपी पास करें:--all --limit 1000।--page-size Nप्रति-अनुरोध चंक को नियंत्रित करता है (अधिकतम 200);--cursor <id>एक पूर्व पृष्ठ केnext_cursorसे फिर से शुरू होता है। - समय फ़िल्टर:
--sinceएक सापेक्ष खिड़की लेता है —15m,1h,6h,24h,7d,30d, याall(डैशबोर्ड की प्रीसेट)।--from/--toस्पष्ट ISO-8601 UTC टाइमस्टैम्पTऔर एक टाइमज़ोन के साथ (उदाहरण के लिए2026-06-01T00:00:00Z) एक कस्टम रेंज के लिए और--sinceको ओवरराइड करते हैं; एक स्पेस-सेपरेटेड या टाइमज़ोन-रहित मान एक उपयोग त्रुटि है। --fields a,b,c(परevents,sessions,evals,errors) आउटपुट को उन कुंजियों तक सीमित करता है, तालिका और--jsonदोनों के लिए। अज्ञात नाम वैध सूची के साथ अस्वीकार किए जाते हैं — फ़ील्ड नाम खोजने का एक सस्ता तरीका।--file payload.json(या--file -stdin को पढ़ने के लिए) एक पूर्ण JSON अनुरोध बॉडी प्रदान करता है जहां एक संसाधन के पास एक जटिल आकार है —alerts create/update,settings set, औरusers create/updateपर। सहेजी गई क्वेरी SQL के बजाय--sql @file.sqlका उपयोग करता है।- मल्टी-मान फ़िल्टर कोमा-सेपरेटेड हैं → एक सेट के रूप में मिलान किया गया (एक फ़िल्टर के भीतर संघ, फ़िल्टर में AND):
--event-type tool_use,tool_result। क्लिक विकल्प variadic नहीं हैं, इसलिए--add a bटूटता है —--add a,bका उपयोग करें, फ़्लैग को दोहराएं (--add a --add b), या उद्धरण करें (--add "a b")।
कमांड संदर्भ
CLI के पास 18 शीर्ष-स्तरीय कमांड हैं। सभी पढ़ें कमांड--json और ऊपर वैश्विक विकल्प स्वीकार करते हैं; किसी भी एक के लिए विस्तृत फ़्लैग सूची और JSON आकार के लिए agenteye <command> -h (या <command> <subcommand> -h) चलाएं।
पहचान — login · logout · whoami · orgs · version · help
orgs सक्रिय टेनेंट का निरीक्षण और स्विच करता है:
अवलोकन (केवल पढ़ें) — events · sessions · evals · errors · list
इनमें से कोई भी पुष्टिकरण की जरूरत नहीं है। साझा फ़िल्टर: --session-id, --agent-id, --env (नहीं --environment), और समय सीमा (--since / --from / --to)।
--score KEY:MIN..MAX (evals पर, sessions नहीं) दोहराने योग्य है और AND-संयुक्त है; या तो सीमा वैकल्पिक है (..0.5 का अर्थ है ≤ 0.5, 0.9.. का अर्थ है ≥ 0.9)। प्रति अनुरोध 20 स्कोर फ़िल्टर तक। evals --scores-full सारांश के बजाय संपूर्ण स्कोर ऑब्जेक्ट देता है। एक सेशन को अंत तक पढ़ने के लिए, ईवेंट ट्रेल को इसके मूल्यांकन के साथ संयोजित करें:
प्रबंधन (अनुमति-गेटेड) — keys · users · settings · alerts · incidents
keys — API कुंजियां। रहस्य स्थानीय रूप से उत्पन्न होता है, सर्वर को भेजा जाता है (जो केवल एक हैश संग्रहीत करता है), और बनाएं/पुनर्जन्म पर एक बार दिखाया जाता है — इसे तब कैप्चर करें। --json के साथ यह केवल key फ़ील्ड में दिखाई देता है। नाम द्वारा संदर्भित।
(permission-set ∪ --add) − --remove के रूप में काम करती हैं। टोकन slug:action हैं (उदाहरण के लिए events:read) या slug:action.action एक संसाधन पर कई को विस्तारित करने के लिए (events:read.add → events:read, events:add)। प्रीसेट: read-only, standard, admin। केवल-मानव अनुमतियां (keys:update) एक कुंजी को अनुदान नहीं दी जा सकती हैं।
users — संगठन सदस्य, ईमेल द्वारा संदर्भित (एक UUID id भी स्वीकार किया जाता है)।
settings — एक निश्चित रजिस्ट्री (आप मौजूदा कुंजियों को पढ़ते और बदलते हैं; आप नई कुंजियां नहीं बना सकते)।
alerts — अलर्ट परिभाषाएं, नाम द्वारा संदर्भित। create एक स्थितीय NAME साथ-साथ फ़्लैग या --file के माध्यम से एक पूर्ण JSON बॉडी लेता है।
incidents — अलर्ट घटनाएं, id द्वारा संदर्भित (छोटी ids स्वीकार की जाती हैं)। show पूर्ण गतिविधि लॉग प्रिंट करता है — कार्य करने से पहले इसे पढ़ें।
विश्लेषण और सहायक — query · agent
query — सहेजी गई ClickHouse SQL साथ-साथ एक तदर्थ रनर। सहेजी गई क्वेरीज़ नाम द्वारा संदर्भित हैं; SQL सर्वर-पक्ष में सत्यापित किया जाता है (केवल SELECT/WITH, कथन टाइमआउट, पंक्ति कैप)।
agent — निर्मित डैशबोर्ड सहायक (वही केवल-पढ़ने विश्लेषक जो आप डैशबोर्ड में चैट कर सकते हैं)। चैट एक छोटे chat-id द्वारा संदर्भित हैं (उपसर्ग-हल)।
निकास कोड
| कोड | अर्थ |
|---|---|
| 0 | सफलता |
| 1 | अप्रत्याशित त्रुटि (उदाहरण के लिए डैशबोर्ड ने एक 5xx लौटाया) |
| 2 | उपयोग त्रुटि (अमान्य तर्क, अज्ञात कमांड/फ़्लैग, नाम टकराव) |
| 3 | डैशबोर्ड तक नहीं पहुंचा जा सकता |
| 4 | लॉगिन नहीं है या सेशन समाप्त; agenteye login चलाएं |
| 5 | प्रमाणित, लेकिन आपके खाते में आवश्यक अनुमति नहीं है (संदेश इसका नाम बताता है) |
| 6 | अनुरोधित संसाधन नहीं मिला (उदाहरण के लिए अज्ञात सेशन या घटना id) |
4 पर फिर से प्रमाणित करने के लिए प्रॉम्प्ट करने के लिए, या एक 5 को सतह पर लापता अनुमति के लिए शाखा कर सकता है। एक्जिट-कोड-हैंडलिंग पैटर्न और JSON आउटपुट आकार के लिए एजेंटों के लिए CLI व्यंजन देखें।
यह भी देखें
- एजेंटों के लिए CLI व्यंजन — कॉपी-पेस्ट क्वेरी पैटर्न,
jqएक-लाइनर,--fieldsप्रक्षेपण, निकास-कोड हैंडलिंग, और JSON आउटपुट आकार, कोडिंग एजेंटों के लिए लिखा गया जो CLI को चलाते हैं। - AgentEye CLI कौशल — इस CLI को एक स्थापनशील Claude Code / Codex कौशल के रूप में पैकेज करें ताकि एक कोडिंग एजेंट सादे-अंग्रेजी अनुरोधों से AgentEye को चलाए।
- API कुंजियां —
keys create --add …के पीछे अनुमति मॉडल। - AI सहायक — सहायक को सक्षम करना जो
agent askबात करता है।

