AgentsView विविध साधनांमधील कोडिंग एजंटच्या सत्रांच्या नोंदी एकाच शोधता येणाऱ्या स्थानिक संग्रहात एकत्र करू शकते. परिचित काम शोधायचे आहे, एजंटने प्रत्यक्ष नोंदवलेली वापराची क्षेत्रे पाहायची आहेत आणि खर्चाच्या प्रत्येक आकड्याचा स्रोत ओळखायचा आहे, अशा अभियांत्रिकी प्रमुखासाठी हे मार्गदर्शन आहे.

ही टप्प्याटप्प्याची माहिती AgentsView च्या 9 ऑक्टोबर 2026 रोजीच्या v0.45.0 आवृत्तीच्या दस्तऐवजांवर आणि सध्याच्या क्विक-स्टार्ट व टोकन-वापर मार्गदर्शकांवर आधारित आहे; हे दस्तऐवज 17 ऑक्टोबरला पाहिले. BIG CHANGE ने AgentsView इन्स्टॉल केलेले नाही, प्रतिलेख आयात केलेला नाही किंवा हे टप्पे तपासलेले नाहीत. आपण इन्स्टॉल केलेली आवृत्ती तपासा, कारण दस्तऐवज आणि आवृत्त्यांच्या याद्या बदलू शकतात.

सुरुवात करण्यापूर्वी

वाचण्याची परवानगी असलेले कोडिंग एजंटचे पूर्ण झालेले सत्र, त्या कामातील विशिष्ट शब्दसमूह किंवा सत्र ID आणि त्याची स्थानिक लॉग डायरेक्टरी वाचण्याची परवानगी आवश्यक आहे. Quick Start मध्ये macOS, Windows आणि Linux साठी डेस्कटॉप डाउनलोड, तसेच Linux x86_64 व aarch64, macOS x86_64 व arm64 आणि Windows x86_64 व arm64 साठी CLI wheel दिले आहेत. डेस्कटॉप ॲप तयार पॅकेजमध्ये येते; सोर्सवरून बिल्ड करण्यासाठी 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 परवाना; रिपॉझिटरीत डीफॉल्ट संग्रह स्थानिक असल्याचे म्हटले आहे.