Overview
— tokens saved
— Est. Cost Saved
— active days
— tool calls
— compression
— Avg. Saved/Day
Token Savings (30 days)
Compression Ratio
Tokemon Buddy
Profile
— Tokens Saved
— Cost Saved
— Tool Calls
— Savings Rate
— Cache Hit Rate
Daily Activity
Savings Rate Trend
Cache Performance
Token Distribution
Daily Stats
— Total Calls
— Tokens Saved
— Cost Saved
— Top Saver
— Unique Commands
Command Breakdown
MCP vs Hook
Top Savers
Most Expensive
— Knowledge Entries
— Errors Detected
— Errors Prevented
Knowledge
Bug Memory
— Latest CEP Score
— Avg Score
— Best Score
— Avg Cache Hit Rate
— Sessions Tracked
CEP Score Over Time
Cache Hit Rate Trend
Compression Rate Trend
Mode Diversity Over Time
Learned Compression Thresholds
These are personalized thresholds lean-ctx learned from your usage patterns. Higher efficiency = better compression for that file type.
What Adaptive Models Do For You
Every time lean-ctx reads a file via ctx_read, it decides how to compress it. Without models, it uses conservative defaults. With models, it picks the best compression mode automatically - saving you 40–90% tokens per file.
Without Models
ctx_read("config.rs") → uses full modeResult: 2,400 tokens
lean-ctx doesn't know that
signatures mode works great for .rs config files. With Models
ctx_read("config.rs") → model picks signatures modeResult: 380 tokens (84% saved)
The model learned this from 200+ community contributions.
How Models Are Built
1. You use lean-ctx
Every file read records which compression mode was used and how well it performed.
2. You run sync
lean-ctx sync anonymously contributes: file extension, size bucket, best mode, compression ratio.3. Server aggregates
The cloud finds the best mode per (extension, size) with confidence scores from all users.
4. Models download
Next sync downloads updated models. Your
ctx_read calls use them immediately. Priority chain: Local history (your own past reads) → Adaptive Models (community) → Built-in defaults. Models only activate when you haven't read a file before.
Compression Modes
| Mode | What It Does | Best For | Typical Savings |
|---|---|---|---|
| full | Reads entire file, caches it | Files you'll edit | 0% (but cached for re-reads) |
| map | Dependencies + exports + key signatures | Context-only files | 60–80% |
| signatures | API surface only (fn/class/struct defs) | Large libraries, .d.ts files | 80–97% |
| aggressive | Strips syntax noise, keeps meaning | Verbose configs (YAML, XML) | 50–70% |
| entropy | Shannon + Jaccard filtering | Data-heavy files, logs | 40–90% |
Adaptive Models
Profile
API Key
Your authentication key for CLI access. Keep it secret.
Connect Terminal
Link your terminal to sync stats, models, and knowledge with your cloud dashboard.
lean-ctx login your@email.com lean-ctx sync