how to get statistics for lean-ctx proxy on history

[maplewf]

Hello,

I'm trying to get statistics for lean-ctx proxy about how many tokens it saves. Lean-ctx did provide the command lean-ctx proxy status, but it seems only print data in memory, it will be lost once proxy is restarted. Besides, it only provides very rough statistics data, it can't be devided into sessions and it doesn't have historical data.

So is there any way that I can get those detailed statistics data for lean-ctx proxy.

Thanks.

[yvgude]

Hey @maplewf — great question! lean-ctx actually has three layers of statistics, each solving a different need:

1. Quick CLI check: lean-ctx gain

Shows a terminal summary with total tokens saved, compression rate, USD saved, trend sparkline, and energy:

lean-ctx gain
lean-ctx gain --json    # machine-readable JSON export of all stats

This survives proxy restarts — it reads from the persisted stats file, not from memory.

2. Verified savings ledger: lean-ctx savings

This is the auditable, per-event ledger with SHA-256 chain integrity:

lean-ctx savings              # summary
lean-ctx savings verify       # verify chain integrity
lean-ctx savings export       # export the full ledger

It records every compression event individually (currently 31k+ events on my machine), broken down by model and token stream. It has been recording since it was introduced and survives restarts.

3. Web dashboard: lean-ctx dashboard

This is the most detailed view — a full web cockpit at localhost:3333 with:

• Historical charts (7d / 30d / 90d / All time ranges)
• Per-project breakdowns (531 connected projects on my setup)
• Context health status
• Top commands ranked by savings
• Compression rate over time
• Cost savings with measured vs estimated split
• Gain score and level progression

lean-ctx dashboard              # opens in browser
lean-ctx dashboard --export     # export HTML report
lean-ctx dashboard --vscode     # open as editor tab in VS Code/Cursor

The dashboard reads from the same persisted ledger, so all data survives restarts.

Summary

Need	Command	Persisted?	Detail level
Quick check	lean-ctx gain	✅	Summary
Auditable proof	lean-ctx savings	✅	Per-event
Visual + historical	lean-ctx dashboard	✅	Full charts + per-project
Machine-readable	lean-ctx gain --json	✅	Full JSON

All of these persist across proxy restarts. lean-ctx proxy status is intentionally just a quick health check of the running process — for real statistics, use the commands above.