lean-ctx suit chaque token économisé à travers toutes les sessions. Ce guide explique comment accéder, interpréter et partager vos données d'économies via les tableaux de bord en terminal, l'interface web, les rapports wrapped et les benchmarks.
Toutes les données sont stockées localement dans ~/.lean-ctx/stats.json et persistent entre les sessions et les redémarrages.
Tableau de bord terminal - lean-ctx gain
La méthode principale pour consulter vos économies. Exécutez lean-ctx gain dans n'importe quel terminal pour voir un tableau de bord visuel avec couleurs, barres, sparklines et estimations en 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: ▁▃▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁Ce que signifient les chiffres
| Métrique | Signification |
|---|---|
| tokens saved | Total des tokens retirés du contexte LLM sur toutes les sessions. |
| compression | Pourcentage moyen de tokens supprimés. Plus c'est élevé, plus c'est efficace. |
| commands | Total des commandes shell compressées par le hook shell. |
| USD saved | Estimation des économies en coût basée sur le prix moyen des tokens (2,50 $/1M de tokens en entrée). |
| Top Commands | Quels outils CLI ont le plus économisé de tokens, classés par économies totales. |
| 30-day sparkline | Tendance visuelle sur 30 jours de l'activité d'économies quotidiennes. |
Mode en direct - lean-ctx gain --live
Tableau de bord avec rafraîchissement automatique toutes les 2 secondes.
$ 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 quitQuand l'utiliser : Lancez-le dans un terminal secondaire pendant vos sessions de codage pour suivre les économies en temps réel.
Graphiques et tableaux
lean-ctx gain --graph
Graphique d'économies sur 30 jours avec barres quotidiennes.
$ 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.7Mlean-ctx gain --daily
Tableau jour par jour avec colonnes pour les tokens économisés, le taux de compression, le nombre de commandes et les 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 │
└────────────┴──────────┴───────┴──────┴────────┘Tableau de bord web - lean-ctx dashboard
Tableau de bord interactif dans le navigateur sur http://localhost:3333.
lean-ctx dashboard # default port 3333
lean-ctx dashboard --port=8080 # custom portPanneaux du tableau de bord
| Panneau | Contenu |
|---|---|
| Vue d'ensemble des statistiques | Total des tokens économisés, taux de compression, USD, nombre de commandes - mêmes données que gain |
| Activité MCP | Appels récents aux outils MCP, outils les plus utilisés, temps de réponse |
| Agents actifs | Agents IA actuellement enregistrés via ctx_agent. Affiche le nom, le rôle, le statut et le heartbeat de l'agent. |
| Connaissances du projet | Faits stockés via ctx_knowledge, regroupés par catégorie avec scores de confiance. |
Points de terminaison API
Le tableau de bord expose une API JSON que vous pouvez interroger directement :
| Point de terminaison | Données |
|---|---|
GET /api/stats | Statistiques d'économies de tokens (identique à gain --json) |
GET /api/mcp | Données d'utilisation des outils MCP |
GET /api/agents | Registre des agents actifs |
GET /api/knowledge | Base de connaissances du projet |
Rapports Wrapped - lean-ctx wrapped
Un « Spotify Wrapped » pour vos économies de tokens. Génère un rapport-bilan partageable.
lean-ctx wrapped # current week
lean-ctx wrapped --week # current week (explicit)
lean-ctx wrapped --month # current month
lean-ctx wrapped --all # lifetime statsExemple de sortie
$ 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)Rapport CEP - lean-ctx cep
Le rapport du Cognitive Efficiency Protocol montre comment lean-ctx optimise le raisonnement du 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% ███Benchmarking
Mesurez les économies exactes de tokens sur de vrais fichiers de projet avec 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]
Générez un rapport Markdown que vous pouvez partager ou commiter dans votre dépôt.
lean-ctx benchmark report src/ > BENCHMARK.mdLe rapport inclut des analyses par fichier, des comparaisons de modes et des statistiques agrégées.
Export JSON - lean-ctx gain --json
Exportez toutes les statistiques au format JSON pour le scripting, l'intégration CI/CD ou des tableaux de bord personnalisés.
lean-ctx gain --json > stats.jsonLe JSON inclut :
- Total des tokens économisés et taux de compression
- Détail par commande (nom, nombre d'exécutions, tokens économisés)
- Historique quotidien (date, économies, taux, commandes)
- Estimations en USD
Exemple : extraire les économies totales dans un script CI :
SAVED=$(lean-ctx gain --json | jq '.total_saved')
echo "lean-ctx saved $SAVED tokens this session"Calcul en USD
lean-ctx estime les économies en USD sur la base du prix moyen des tokens LLM en entrée. Le tarif par défaut est de 2,50 $ par million de tokens en entrée.
La formule est :
USD saved = (tokens saved / 1,000,000) × $2.50Il s'agit d'une estimation conservatrice - les économies réelles peuvent être supérieures si vous utilisez des modèles plus coûteux ou inférieures avec des modèles moins chers.