ドキュメント

アナリティクスとダッシュボード

token節約量の監視、ダッシュボードの解釈、ベンチマークの実行、レポートの共有方法。

lean-ctxはすべてのセッションにわたって節約したtokenを追跡します。このガイドでは、ターミナルダッシュボード、Web 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単価（100万入力tokenあたり$2.50）に基づく推定コスト節約。
Top Commands合計節約量でランク付けされた、最もtokenを節約したCLIツール。
30-day sparkline30日間の日別節約活動のビジュアルトレンド。

ライブモード - 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  │
  └────────────┴──────────┴───────┴──────┴────────┘

Webダッシュボード - 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

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節約額を推定します。デフォルトレートは100万入力tokenあたり$2.50です。

計算式：

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

これは控えめな推定です - より高価なモデルを使用する場合は実際の節約額がより高く、より安価なモデルの場合はより低くなる可能性があります。