प्रलेखन

एनालिटिक्स और डैशबोर्ड

टोकन बचत की निगरानी, डैशबोर्ड की व्याख्या, बेंचमार्क चलाना और रिपोर्ट साझा करना कैसे करें।

lean-ctx सभी सत्रों में बचाए गए हर टोकन को ट्रैक करता है। यह गाइड बताती है कि टर्मिनल डैशबोर्ड, वेब UI, रैप्ड रिपोर्ट और बेंचमार्क के माध्यम से अपने बचत डेटा तक कैसे पहुँचें, उसकी व्याख्या करें और साझा करें।

सभी डेटा स्थानीय रूप से ~/.lean-ctx/stats.json पर संग्रहीत है और सत्रों और पुनरारंभ में बना रहता है।

टर्मिनल डैशबोर्ड - lean-ctx gain

अपनी बचत जाँचने का प्राथमिक तरीका। रंगों, बार, स्पार्कलाइन और USD अनुमानों के साथ विज़ुअल डैशबोर्ड देखने के लिए किसी भी टर्मिनल में lean-ctx gain चलाएँ।

$ lean-ctx gain

  ◆ lean-ctx  Token Savings Dashboard
  ────────────────────────────────────────────────────────

   7.8M          67.8%          3,994        $43.14
   tokens saved  compression    commands     USD saved

  Top Commands
  ──────────────
  curl     328x  ████████████████████  3.2M saved
  git      412x  ██████████████        1.8M saved
  cargo    156x  ██████████            1.1M saved
  npm       89x  ████                  420K saved

  30-day sparkline: ▁▃▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁

संख्याओं का क्या अर्थ है

मेट्रिकअर्थ
tokens savedसभी सत्रों में LLM संदर्भ से हटाए गए कुल टोकन।
compressionहटाए गए टोकन का औसत प्रतिशत। अधिक = अधिक कुशल।
commandsशेल हुक द्वारा कम्प्रेस की गई कुल शेल कमांड।
USD savedऔसत टोकन मूल्य निर्धारण ($2.50/1M इनपुट टोकन) के आधार पर अनुमानित लागत बचत।
Top Commandsकुल बचत के अनुसार रैंक किए गए, कौन से CLI टूल्स ने सबसे अधिक टोकन बचाए।
30-day sparklineदैनिक बचत गतिविधि का 30-दिन विज़ुअल ट्रेंड।

लाइव मोड - lean-ctx gain --live

हर 2 सेकंड में अपडेट होने वाला ऑटो-रिफ़्रेशिंग डैशबोर्ड।

$ lean-ctx gain --live

  ◆ lean-ctx  LIVE  refreshing every 2s
  ────────────────────────────────────────────────────────

   7.8M          67.8%          3,994        $43.14
   tokens saved  compression    commands     USD saved

  Session: 42 cmds | 89.2K saved | 94.1% rate ▁▃█▇██▁█

  Press q to quit

कब उपयोग करें: कोडिंग सत्रों के दौरान एक साइड टर्मिनल में चलाएँ ताकि बचत होते ही मॉनिटर कर सकें।

चार्ट और तालिकाएँ

lean-ctx gain --graph

दैनिक बार के साथ 30-दिन बचत चार्ट।

$ lean-ctx gain --graph

  Token Savings (30 days)
  ──────────────────────────────

  03-20 │ ██████████████████████ 1.0M
  03-21 │ ███████████████       690K
  03-22 │ ████████████████████████ 1.1M
  03-23 │ █                       9.4K
  03-24 │ ██████████████████████ 1.7M

lean-ctx gain --daily

टोकन बचत, कम्प्रेशन दर, कमांड गणना और USD के कॉलम के साथ दिन-दर-दिन तालिका।

$ lean-ctx gain --daily

  ┌────────────┬──────────┬───────┬──────┬────────┐
  │ Date       │ Saved    │ Rate  │ Cmds │ USD    │
  ├────────────┼──────────┼───────┼──────┼────────┤
  │ 2026-03-28 │ 1.7M     │ 72.4% │ 412  │ $4.25  │
  │ 2026-03-27 │ 1.1M     │ 68.9% │ 289  │ $2.75  │
  │ 2026-03-26 │ 690K     │ 71.2% │ 187  │ $1.73  │
  └────────────┴──────────┴───────┴──────┴────────┘

वेब डैशबोर्ड - lean-ctx dashboard

http://localhost:3333 पर इंटरैक्टिव ब्राउज़र-आधारित डैशबोर्ड।

lean-ctx dashboard              # default port 3333
lean-ctx dashboard --port=8080  # custom port

डैशबोर्ड पैनल

पैनलसामग्री
आँकड़े अवलोकनकुल टोकन बचत, कम्प्रेशन दर, USD, कमांड गणना - gain के समान डेटा
MCP गतिविधिहाल की MCP टूल कॉल, सबसे अधिक उपयोग किए जाने वाले टूल, प्रतिक्रिया समय
सक्रिय एजेंटctx_agent के माध्यम से वर्तमान में पंजीकृत AI एजेंट। एजेंट नाम, भूमिका, स्थिति और हार्टबीट दिखाता है।
प्रोजेक्ट ज्ञानctx_knowledge के माध्यम से संग्रहीत तथ्य, विश्वास स्कोर के साथ श्रेणी के अनुसार समूहीकृत।

API एंडपॉइंट

डैशबोर्ड एक JSON API सर्व करता है जिसे आप सीधे क्वेरी कर सकते हैं:

एंडपॉइंटडेटा
GET /api/statsटोकन बचत आँकड़े (gain --json के समान)
GET /api/mcpMCP टूल उपयोग डेटा
GET /api/agentsसक्रिय एजेंट रजिस्ट्री
GET /api/knowledgeप्रोजेक्ट ज्ञान भंडार

रैप्ड रिपोर्ट - lean-ctx wrapped

आपकी टोकन बचत के लिए "Spotify Wrapped"। एक साझा करने योग्य रिपोर्ट कार्ड जनरेट करता है।

lean-ctx wrapped           # current week
lean-ctx wrapped --week    # current week (explicit)
lean-ctx wrapped --month   # current month
lean-ctx wrapped --all     # lifetime stats

उदाहरण आउटपुट

$ lean-ctx wrapped --month

  ◆ Your March 2026 Wrapped
  ────────────────────────────────

  4.9M tokens saved
  3,241 commands compressed
  $12.16 USD saved

  Top pattern: curl (97% compression)
  You're in the top 5% of lean-ctx users

  Best day: March 24 - 1.7M tokens saved
  Most used mode: map (42% of reads)

CEP रिपोर्ट - lean-ctx cep

Cognitive Efficiency Protocol रिपोर्ट दिखाती है कि lean-ctx LLM तर्क को कैसे अनुकूलित करता है।

$ lean-ctx cep

  CEP Impact Report
  ────────────────────────────────

  Score trend:  ▁▃▅▇██▇█  (improving)
  Cache hits:   94.2% (re-reads served from cache)
  Mode distribution:
    full:        42%  ████████████████
    map:         31%  ████████████
    signatures:  18%  ███████
    diff:         9%  ███

बेंचमार्किंग

tiktoken का उपयोग करके वास्तविक प्रोजेक्ट फ़ाइलों पर सटीक टोकन बचत मापें।

lean-ctx benchmark run [path] [--json]

$ lean-ctx benchmark run src/

  Benchmarking 42 files...

  src/auth.ts (123 lines)
    full:       3,517 tokens
    map:          412 tokens (88% saved)
    signatures:   252 tokens (93% saved)
    entropy:      312 tokens (91% saved)

  src/server.ts (456 lines)
    full:       8,234 tokens
    map:          891 tokens (89% saved)
    signatures:   534 tokens (94% saved)

  ── Summary ──────────────────────
  42 files | 89,412 total tokens
  Average savings: map 87% | signatures 92% | entropy 85%

lean-ctx benchmark report [path]

एक Markdown रिपोर्ट जनरेट करें जिसे आप साझा या अपने रिपॉजिटरी में कमिट कर सकते हैं।

lean-ctx benchmark report src/ > BENCHMARK.md

रिपोर्ट में प्रति-फ़ाइल विवरण, मोड तुलना और समग्र आँकड़े शामिल हैं।

JSON एक्सपोर्ट - lean-ctx gain --json

स्क्रिप्टिंग, CI/CD एकीकरण या कस्टम डैशबोर्ड के लिए सभी आँकड़ों को JSON के रूप में एक्सपोर्ट करें।

lean-ctx gain --json > stats.json

JSON में शामिल है:

  • कुल टोकन बचत और कम्प्रेशन दर
  • प्रति-कमांड विवरण (कमांड नाम, गणना, बचाए गए टोकन)
  • दैनिक इतिहास (तिथि, बचत, दर, कमांड)
  • USD अनुमान

उदाहरण: CI स्क्रिप्ट में कुल बचत निकालें:

SAVED=$(lean-ctx gain --json | jq '.total_saved')
echo "lean-ctx saved $SAVED tokens this session"

USD गणना

lean-ctx औसत LLM इनपुट टोकन मूल्य निर्धारण के आधार पर USD बचत का अनुमान लगाता है। डिफ़ॉल्ट दर $2.50 प्रति 1M इनपुट टोकन है।

सूत्र है:

USD saved = (tokens saved / 1,000,000) × $2.50

यह एक रूढ़िवादी अनुमान है - यदि आप अधिक महँगे मॉडल उपयोग करते हैं तो वास्तविक बचत अधिक हो सकती है या सस्ते मॉडल उपयोग करते हैं तो कम।