ডকুমেন্টেশন

অ্যানালিটিক্স ও ড্যাশবোর্ড

কীভাবে token সাশ্রয় মনিটর করবেন, ড্যাশবোর্ড ব্যাখ্যা করবেন, বেঞ্চমার্ক চালাবেন এবং রিপোর্ট শেয়ার করবেন।

lean-ctx সব সেশন জুড়ে প্রতিটি সাশ্রয়কৃত token ট্র্যাক করে। এই গাইড ব্যাখ্যা করে কীভাবে টার্মিনাল ড্যাশবোর্ড, ওয়েব UI, wrapped রিপোর্ট এবং বেঞ্চমার্কের মাধ্যমে আপনার সাশ্রয় ডেটা অ্যাক্সেস, ব্যাখ্যা এবং শেয়ার করবেন।

সব ডেটা ~/.lean-ctx/stats.json-এ স্থানীয়ভাবে সংরক্ষিত এবং সেশন ও রিস্টার্ট জুড়ে স্থায়ী।

টার্মিনাল ড্যাশবোর্ড - lean-ctx gain

আপনার সাশ্রয় চেক করার প্রাথমিক উপায়। যেকোনো টার্মিনালে lean-ctx gain চালান এবং রঙ, বার, স্পার্কলাইন এবং USD অনুমানসহ একটি ভিজ্যুয়াল ড্যাশবোর্ড দেখুন।

$ 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 কনটেক্সট থেকে মুছে ফেলা মোট token।
compressionমুছে ফেলা token-এর গড় শতাংশ। বেশি = আরো দক্ষ।
commandsশেল হুক দ্বারা কম্প্রেস করা মোট শেল কমান্ড।
USD savedগড় token মূল্যের ($2.50/1M ইনপুট token) ভিত্তিতে আনুমানিক খরচ সাশ্রয়।
Top Commandsকোন CLI টুল সবচেয়ে বেশি token সাশ্রয় করেছে, মোট সাশ্রয় অনুযায়ী র‍্যাঙ্কড।
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

token সাশ্রয়, কম্প্রেশন রেট, কমান্ড সংখ্যা এবং 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

ড্যাশবোর্ড প্যানেল

প্যানেলবিষয়বস্তু
পরিসংখ্যান সারসংক্ষেপমোট সাশ্রয়কৃত token, কম্প্রেশন রেট, USD, কমান্ড সংখ্যা - gain-এর মতো একই ডেটা
MCP কার্যকলাপসাম্প্রতিক MCP টুল কল, কোন টুল সবচেয়ে বেশি ব্যবহৃত, রেসপন্স টাইম
সক্রিয় এজেন্টctx_agent-এর মাধ্যমে বর্তমানে নিবন্ধিত AI এজেন্ট। এজেন্টের নাম, ভূমিকা, স্ট্যাটাস এবং হার্টবিট দেখায়।
প্রজেক্ট নলেজctx_knowledge-এর মাধ্যমে সংরক্ষিত তথ্য, কনফিডেন্স স্কোরসহ ক্যাটাগরি অনুযায়ী গ্রুপ করা।

API এন্ডপয়েন্ট

ড্যাশবোর্ড একটি JSON API সরবরাহ করে যা আপনি সরাসরি কুয়েরি করতে পারেন:

এন্ডপয়েন্টডেটা
GET /api/statsToken সাশ্রয়ের পরিসংখ্যান (gain --json-এর মতো)
GET /api/mcpMCP টুল ব্যবহারের ডেটা
GET /api/agentsসক্রিয় এজেন্ট রেজিস্ট্রি
GET /api/knowledgeপ্রজেক্ট নলেজ স্টোর

Wrapped রিপোর্ট - lean-ctx wrapped

আপনার token সাশ্রয়ের "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 ব্যবহার করে প্রকৃত প্রজেক্ট ফাইলে সঠিক token সাশ্রয় পরিমাপ করুন।

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-এ অন্তর্ভুক্ত:

  • মোট সাশ্রয়কৃত token এবং কম্প্রেশন রেট
  • কমান্ড-ভিত্তিক বিশ্লেষণ (কমান্ডের নাম, সংখ্যা, সাশ্রয়কৃত token)
  • দৈনিক ইতিহাস (তারিখ, সাশ্রয়, রেট, কমান্ড)
  • USD অনুমান

উদাহরণ: একটি CI স্ক্রিপ্টে মোট সাশ্রয় বের করুন:

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

USD হিসাব

lean-ctx গড় LLM ইনপুট token মূল্যের ভিত্তিতে USD সাশ্রয় অনুমান করে। ডিফল্ট রেট হলো প্রতি 1M ইনপুট token-এ $2.50।

সূত্র হলো:

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

এটি একটি রক্ষণশীল অনুমান - আপনি বেশি দামের মডেল ব্যবহার করলে প্রকৃত সাশ্রয় বেশি হতে পারে বা সস্তা মডেল ব্যবহার করলে কম হতে পারে।