AgentsView अलग-अलग टूल के कोडिंग एजेंट सत्रों के लॉग एक खोजे जा सकने वाले स्थानीय संग्रह में रख सकता है। यह गाइड उस इंजीनियरिंग प्रमुख के लिए है जिसे कोई ज्ञात काम ढूँढ़ना है, एजेंट ने वास्तव में जो उपयोग फ़ील्ड दर्ज किए हैं उन्हें देखना है, और लागत की हर राशि का स्रोत पहचानना है।

यह चरणबद्ध गाइड AgentsView के 9 अक्टूबर 2026 के v0.45.0 संस्करण और मौजूदा क्विक-स्टार्ट व टोकन-उपयोग गाइड के दस्तावेज़ों पर आधारित है, जिन्हें 17 अक्टूबर को देखा गया। BIG CHANGE ने AgentsView इंस्टॉल नहीं किया है, कोई ट्रांसक्रिप्ट आयात नहीं किया है और इन चरणों को आज़माया नहीं है। इंस्टॉल किए गए संस्करण की जाँच करें, क्योंकि दस्तावेज़ और संस्करणों की सूचियाँ बदल सकती हैं।

शुरू करने से पहले

आपको कोडिंग एजेंट का ऐसा पूरा हो चुका सत्र चाहिए जिसे पढ़ने की अनुमति हो, उस काम का कोई विशिष्ट वाक्यांश या सत्र ID, और उसकी स्थानीय लॉग डायरेक्टरी पढ़ने की अनुमति। Quick Start में macOS, Windows और Linux के डेस्कटॉप डाउनलोड हैं। CLI wheel Linux x86_64 और aarch64, macOS x86_64 और arm64, तथा Windows x86_64 और arm64 के लिए हैं। डेस्कटॉप ऐप पहले से पैकेज किया गया है; सोर्स से बिल्ड करने के लिए Go, Node और CGO की अलग आवश्यकताएँ हैं। क्विक-स्टार्ट के अनुसार बुनियादी स्थानीय संग्रह के लिए होस्टेड खाते या API कुंजी की ज़रूरत नहीं है।

सत्र लॉग में प्रॉम्प्ट, सोर्स कोड, टूल इनपुट और गोपनीय जानकारी हो सकती है। केवल वे डायरेक्टरी चुनें जिन्हें जाँचने की आपकी टीम अनुमति देती है। संग्रह किन प्रदाताओं और मूल डायरेक्टरी से डेटा ले सकता है, यह तय करें पहली बार शुरू करने से पहले: केवल agentsview serve चलाने से समर्थित डिफ़ॉल्ट स्रोत तुरंत खोजे और सिंक किए जाते हैं। इस अभ्यास में वेब UI को दस्तावेज़ में दिए लूपबैक पते पर ही रखें। केवल इस सवाल का जवाब पाने के लिए होस्टेड कच्चे डेटा का सिंक, PostgreSQL या ClickHouse को डेटा भेजना, Gist प्रकाशन, जनरेट किए गए इनसाइट या होस्टेड एम्बेडिंग एंडपॉइंट चालू न करें। सिमैंटिक खोज वैकल्पिक है; सामान्य पूर्ण-पाठ खोज स्थानीय इंडेक्स से काम करती है।

1. इंस्टॉल करें और चलने वाली फ़ाइल पहचानें

इस इंस्टॉलेशन गाइड में से एक तरीका चुनें। अलग CLI के लिए दस्तावेज़ में दिया स्थायी Python इंस्टॉलेशन यह है:

Terminal
pip install agentsview
agentsview --version

गाइड में uvx agentsview से बिना स्थायी इंस्टॉलेशन के चलाने का तरीका, अलग-अलग प्लेटफ़ॉर्म के इंस्टॉलर और डेस्कटॉप पैकेज भी हैं। macOS पर Homebrew cask ऐप में शामिल CLI को लिंक करता है; DMG से इंस्टॉल ऐप की CLI डायरेक्टरी को PATH में जोड़ना पड़ सकता है। संस्करण पर भरोसा करने से पहले पुष्टि करें कि शेल कौन-सी एक्ज़ीक्यूटेबल फ़ाइल ढूँढ़ रहा है। GitHub ने v0.45.0 को 9 अक्टूबर का संस्करण बताया है, लेकिन स्क्रीन और रिपोर्ट का ढाँचा समझते समय अपने --version परिणाम का इस्तेमाल करें।

2. पहली सिंक से पहले स्रोत सीमित करें

होस्ट पर CLI या डेस्कटॉप इंस्टॉलेशन के लिए एक नई डेटा डायरेक्टरी और उसकी config.toml पहले तैयार करें, उसके बाद AgentsView शुरू करें। कॉन्फ़िगरेशन गाइड बताती है कि disabled_agents स्थानीय फ़ाइलसिस्टम प्रदाताओं को बाहर रखने के लिए है और [agents.<id>].dirs किसी एक प्रदाता की डिफ़ॉल्ट मूल डायरेक्टरी बदलने के लिए है। बाकी सभी प्रदाताओं के ID उस गाइड की Session Discovery तालिका से लेकर disabled_agents में सूचीबद्ध करें, और एकमात्र अधिकृत प्रदाता का dirs स्वीकृत मूल डायरेक्टरी पर सेट करें। उदाहरण के लिए [agents.codex] के साथ dirs = ["/approved/codex/sessions"] देने पर Codex की डिफ़ॉल्ट डायरेक्टरी बदल जाती हैं; अपने सिस्टम के अनुसार पथ बदलें। पूरी बहिष्करण सूची न हो तो अभी होस्ट डेमन शुरू न करें। केवल CODEX_SESSIONS_DIR या CLAUDE_PROJECTS_DIR को ओवरराइड करने से उसी प्रदाता का मूल पथ बदलता है, लेकिन दूसरे प्रदाता अपने डिफ़ॉल्ट तरीके से खोजे जा सकते हैं।

इस ऑडिट के लिए नया AGENTSVIEW_DATA_DIR इस्तेमाल करें, अगर पुराने संग्रह में पहले से असंबंधित सत्र हो सकते हैं। कॉन्फ़िगरेशन गाइड के अनुसार निष्क्रिय प्रदाताओं के पहले से संग्रहीत सत्र उपलब्ध रहते हैं, इसलिए सेटिंग बदलने से पुराना संग्रह साफ़ नहीं होता। गाइड यह भी कहती है कि disabled_agents स्थानीय खोज और निगरानी को नियंत्रित करता है, दूरस्थ आयात या निर्यात को नहीं; इस स्थानीय काम के लिए दूरस्थ होस्ट और निर्यात गंतव्य बिना कॉन्फ़िगर किए छोड़ें।

अगर बाकी सभी प्रदाताओं की बहिष्करण सूची रखना व्यावहारिक न हो, तो अलग-थलग कंटेनर विकल्प है। Quick Start का Docker उदाहरण UI केवल 127.0.0.1 पर उपलब्ध कराता है, एजेंट का एक स्रोत केवल-पढ़ने योग्य रूप में माउंट करता है और अलग डेटा वॉल्यूम रखता है। माउंट करें केवल अधिकृत स्रोत की मूल डायरेक्टरी, और नए कंटेनर के भीतर उससे मेल खाने वाला डायरेक्टरी वेरिएबल सेट करें; प्रोजेक्ट के Compose उदाहरण के दूसरे माउंट छोड़ दें। कंटेनर को होस्ट की केवल स्पष्ट रूप से माउंट की गई सत्र डायरेक्टरी दिखती हैं। प्रकाशित Docker इमेज Linux amd64 और arm64 को कवर करती हैं; इस रास्ते के लिए काम कर रहा Docker इंस्टॉलेशन चाहिए।

3. स्थानीय संग्रह बनाएँ

सीमित स्रोतों वाली होस्ट CLI के लिए दस्तावेज़ में दिया फ़ोरग्राउंड सर्वर शुरू करें:

Terminal
agentsview serve

चरण 2 में स्रोत का दायरा लागू करने और जाँचने के बाद यह ~/.agentsview/sessions.db या चुनी गई डेटा डायरेक्टरी को आरंभ करता है, सक्रिय एजेंट लॉग खोजता है, उन्हें सिंक करता है, बदलावों पर नज़र रखता है और http://127.0.0.1:8080 खोलता है। वह टर्मिनल खुला रखें। बैकग्राउंड प्रक्रिया चाहिए तो agentsview daemon start और agentsview daemon status इस्तेमाल करें; डेस्कटॉप ऐप अपना बैकएंड खुद संभालता है। पहले से चल रहा कोई संगत सर्वर केवल अपना URL बता सकता है, इसलिए यह मानने से पहले कि नई कॉन्फ़िगरेशन ने डेटा आयात नियंत्रित किया, चल रहे डेमन की जाँच करें।

अगर अलग-थलग कंटेनर चुना है, तो उसके एकमात्र केवल-पढ़ने योग्य स्रोत माउंट और नए डेटा वॉल्यूम की जाँच करके दस्तावेज़ वाले Docker कमांड से शुरू करें। उसका लूपबैक UI इस्तेमाल करें और बाद की agentsview CLI रिपोर्ट उसी कंटेनर के भीतर चलाएँ, ताकि वे वही संग्रह पढ़ें। साथ में होस्ट पर बिना स्रोत-सीमा वाला serve न चलाएँ।

जाँचें कि ज्ञात काम का स्रोत दिखता है और अनचाहे प्रदाता नहीं दिखते। सत्र गायब हो तो सत्र मौजूद नहीं है मानने से पहले स्वीकृत पथ, प्रदाता की सेटिंग और सिंक की स्थिति जाँचें। रिपोर्ट से पहले हाल में बदली फ़ाइलें शामिल करनी हों तो agentsview sync चलाएँ; सर्वर भी बदलावों पर नज़र रखता है। किसी पूरी री-सिंक से पहले कॉन्फ़िगर किया दायरा फिर जाँचें।

4. काम खोजें और ट्रांसक्रिप्ट सत्यापित करें

वेब UI में Ctrl/Cmd+K से ज्ञात काम का कोई विशिष्ट वाक्यांश हूबहू खोजें। प्रोजेक्ट, एजेंट या तारीख से सूची सीमित करें, संभावित परिणाम खोलें और उसके संदेश व टूल कॉल जाँचें। पूरा सत्र ID या UUID हो तो Ctrl/Cmd+G उसे सीधे खोलता है। ये नियंत्रण Quick Start में दिए गए हैं। एजेंट, सत्र ID और तारीख नोट करें, ताकि उपयोग का परिणाम सही बातचीत से जोड़ सकें।

हूबहू खोज से काम न मिले तो छोटा वाक्यांश आज़माएँ और पुष्टि करें कि मूल एजेंट ने AgentsView द्वारा पढ़ी जा सकने वाली डायरेक्टरी में स्थानीय ट्रांसक्रिप्ट लिखा है। केवल किसी दूरस्थ सेवा, असमर्थित फ़ॉर्मैट या कॉन्फ़िगर किए मूल पथों से बाहर की डायरेक्टरी में मौजूद काम और खोजने से वापस नहीं मिलता। स्थानीय स्रोत न मिलने की नियमित मरम्मत के रूप में सिमैंटिक इंडेक्सिंग या ट्रांसक्रिप्ट अपलोड चालू न करें।

5. सत्र के उपयोग फ़ील्ड देखें

मिले हुए सत्र का उपयोग दृश्य खोलें और उसमें मौजूद दर्ज मॉडल, इनपुट, आउटपुट, कैश निर्माण और कैश रीड फ़ील्ड पहचानें। टोकन-उपयोग गाइड लागत रिपोर्टिंग को प्रायोगिक और अभी विकसित हो रही बताती है। AgentsView स्रोत लॉग से मॉडल और टोकन मेटाडेटा लेता है और संदेश की पंक्तियों में कच्चा टोकन उपयोग रखता है। स्रोत द्वारा स्पष्ट लागत दी गई हो तो उसे इस्तेमाल करता है; वरना उपलब्ध टोकन और मॉडल की दरों से लागत निकालता है। JSON में स्रोत-परिचय के लिए इन्हें reported, computed या mixed कहा जाता है।

उस एक सत्र का मशीन-पठनीय रिकॉर्ड सहेजना हो तो प्रोजेक्ट के CLI उदाहरण में इस्तेमाल किया गया कमांड है agentsview session usage SESSION_ID --format json। SESSION_ID की जगह ट्रांसक्रिप्ट में सत्यापित ID रखें, फिर JSON को काम के नोट के साथ सहेजें। कोई कुल राशि उद्धृत करने से पहले उस आउटपुट में दिए मॉडल, टोकन श्रेणियाँ और लागत का स्रोत जाँचें।

खाली फ़ील्ड या गायब मॉडल को अज्ञात मानें। एजेंट ने जो उपयोग कभी लिखा ही नहीं, AgentsView उसे फिर से नहीं बना सकता। संस्करण नोट्स के अनुसार Junie CLI आयात में केवल IDE में मौजूद बातचीत और टूल कॉल शामिल नहीं होते, जबकि Antigravity के साधारण-पाठ फ़ॉलबैक में ट्रांसक्रिप्ट का पाठ होता है, टोकन उपयोग या लागत नहीं। ये ठोस उदाहरण बताते हैं कि खोजे जा सकने वाले सत्र में खर्च का पूरा आँकड़ा होना ज़रूरी नहीं। स्रोत से मिली राशि पूरे सत्र का योग भी हो सकती है, जबकि प्रति-मॉडल बँटवारा अनुमान ही रहता है।

6. दैनिक रिपोर्ट का दायरा सीमित करें

Usage पेज के तारीख, प्रोजेक्ट और एजेंट फ़िल्टर से सत्र वाले दिन को देखें। पेज पर Top Sessions by Cost तालिका भी है, जो अलग-अलग ट्रांसक्रिप्ट से जोड़ती है। जाँची जा सकने वाली टर्मिनल रिपोर्ट के लिए नीचे सत्र की स्थानीय तारीख और एजेंट का नाम बदलें:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

दैनिक तालिका बिना कैश वाला इनपुट, आउटपुट, कैश निर्माण और कैश रीड अलग दिखाती है। प्रति-मॉडल पंक्तियाँ तब मिलती हैं जब --breakdown सेट हो। तारीख सिस्टम के समय क्षेत्र के अनुसार समूहित होती है, जब तक --timezone न दिया जाए। दिन के कुल में उस एजेंट के दूसरे सत्र भी हो सकते हैं; यह दायरे और परिमाण की जाँच है, किसी एक काम की लागत नहीं। दैनिक रिपोर्ट के साथ सत्र ID रखें और देखें कौन-सी पंक्तियाँ वास्तव में उसी की हैं।

मूल्य-सूची लाए बिना रिपोर्ट के लिए --offline जोड़ें। AgentsView के अनुसार यह स्रोत सिंक या डेमन शुरू किए बिना मौजूदा संग्रह पढ़ता है और अपनी अंतर्निहित वैकल्पिक दरें इस्तेमाल करता है। हाल के सत्र बदलाव महत्वपूर्ण हों तो पहले संग्रह ताज़ा करें; ऑफ़लाइन रिपोर्ट नए लॉग नहीं खोज सकती। सामान्य उपयोग कमांड LiteLLM और OpenRouter की दरें ला सकते हैं, जबकि अंतर्निहित सूची इंस्टॉल किए संस्करण के साथ पुरानी होती जाती है।

7. राशि का अर्थ समझें और सेवा रोकें

हर राशि को उसके स्रोत के अनुसार लेबल दें। Computed का अर्थ है कि AgentsView ने दर्ज टोकन को चुनी गई दरों से गुणा किया। Reported का अर्थ है कि स्रोत ने स्पष्ट लागत दी। Mixed का अर्थ है कि रिपोर्ट में कई तरह के आँकड़े मिले हैं। स्रोत से मिली राशि भी इस बात का प्रमाण नहीं है कि पूरे खाते के प्रदाता का बिल मिलान किया जा चुका है। संबंधित प्रदाता के अपने बिलिंग या प्लान रिकॉर्ड अलग से मिलाएँ, खासकर जब सेवा-स्तर, छूट या सदस्यता में मिलने वाली उपयोग मात्रा को ध्यान में रखना ज़रूरी हो। AgentsView के दस्तावेज़ कहते हैं कि संग्रहीत उपयोग में वह स्तर न हो तो वह Batch, Flex, Priority, क्षेत्रीय या एक घंटे के कैश की कीमतों का अनुमान नहीं लगा सकता। टूल की तरफ़ के कुछ टोकन स्थानीय ट्रांसक्रिप्ट में नहीं होते।

सफलता की जाँच ऐसा मिला हुआ ट्रांसक्रिप्ट है जिसका एजेंट, ID और तारीख चुने गए उपयोग दृश्य से मेल खाएँ, उपलब्ध मॉडल व टोकन फ़ील्ड दर्ज हों और अनुपलब्ध फ़ील्ड अज्ञात चिह्नित हों। परिणाम खोजने योग्य स्थानीय संग्रह और सीमित दायरे वाला काम/दिन का उपयोग नोट है, बिल नहीं। फ़ोरग्राउंड में चल रहा agentsview serve रोकने के लिए Ctrl+C इस्तेमाल करें, या बैकग्राउंड सर्वर रोकने के लिए agentsview daemon stop चलाएँ। Quick Start के अनुसार डेमन रोकने पर वेब UI और सत्र निगरानी दोनों बंद होते हैं।

बड़ा बदलाव

स्थानीय ट्रांसक्रिप्ट लागत की चर्चा का पता लगाया जा सकने वाला शुरुआती बिंदु देता है। इंजीनियरिंग प्रमुख किसी राशि को एक खास दर्ज काम तक वापस ले जाकर देख सकता है कि वह एजेंट से आई या मूल्य-सूची से। लॉग अधूरा हो तो रिपोर्ट को वह कमी बनाए रखनी चाहिए।

स्रोत और आगे पढ़ें

  • AgentsView v0.45.0 के संस्करण नोट्स: एजेंट समर्थन, Usage कार्ड, सिंक और कीमतों के व्यवहार में तारीख के साथ दर्ज बदलाव। संस्करण नोट प्रदाता का रिकॉर्ड है, BIG CHANGE का परीक्षण नहीं।
  • AgentsView Quick Start: समर्थित इंस्टॉलेशन रास्ते, सर्वर व डेमन कमांड, स्रोत कॉन्फ़िगरेशन और स्थानीय खोज के नियंत्रण।
  • AgentsView कॉन्फ़िगरेशन: स्रोतों की खोज, प्रदाताओं को बाहर रखना, संग्रह का स्थान और इन नियंत्रणों की सीमाएँ।
  • AgentsView टोकन उपयोग और लागत: स्रोत समर्थन, उपयोग रिपोर्ट, दरों का स्रोत, ऑफ़लाइन मोड और रिपोर्ट की ज्ञात सीमाएँ।
  • AgentsView रिपॉज़िटरी: सोर्स कोड और MIT लाइसेंस; रिपॉज़िटरी डिफ़ॉल्ट संग्रह को स्थानीय बताती है।