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 అంటే నివేదిక పలు రకాలను కలుపుతుంది. మూలం తెలిపిన సంఖ్య కూడా మొత్తం ఖాతాకు సంబంధించిన ప్రొవైడర్ ఇన్వాయిస్‌ను సరిపోల్చి తనిఖీ చేశారనడానికి రుజువు కాదు. సంబంధిత ప్రొవైడర్ సొంత బిల్లింగ్ లేదా ప్లాన్ రికార్డులను విడిగా పోల్చండి; ముఖ్యంగా సేవా స్థాయులు, తగ్గింపులు లేదా సబ్‌స్క్రిప్షన్‌లో కలిసివచ్చే వినియోగ పరిమాణం ముఖ్యమైనప్పుడు. నిల్వ చేసిన వినియోగంలో ఆ స్థాయి లేకపోతే Batch, Flex, Priority, ప్రాంతీయ లేదా ఒక గంట క్యాష్ ధరలను ఊహించలేమని AgentsView పత్రాలు చెబుతాయి. టూల్ వైపు కొన్ని టోకెన్లు స్థానిక సంభాషణ రికార్డుల్లో ఉండవు.

ఎంచుకున్న వినియోగ దృశ్యంతో ఏజెంట్, 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 లైసెన్స్; రిపోజిటరీ డిఫాల్ట్ ఆర్కైవ్‌ను స్థానికమైనదిగా వర్ణిస్తుంది.