Dokumentation

Analysen & Dashboards

Token-Einsparungen überwachen, Dashboards interpretieren, Benchmarks ausführen und Berichte teilen.

lean-ctx verfolgt jeden gesparten Token über alle Sessions. Dieser Guide erklärt, wie du auf deine Einsparungsdaten zugreifst, sie interpretierst und über Terminal-Dashboards, Web-UI, Wrapped-Berichte und Benchmarks teilst.

Alle Daten werden lokal unter ~/.lean-ctx/stats.json gespeichert und überdauern Sessions und Neustarts.

Terminal-Dashboard - lean-ctx gain

Die primäre Methode, deine Einsparungen zu prüfen. Führe lean-ctx gain in einem Terminal aus, um ein visuelles Dashboard mit Farben, Balken, Sparklines und USD-Schätzungen zu sehen.

$ 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: ▁▃▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁

Was die Zahlen bedeuten

MetrikBedeutung
tokens savedGesamte aus dem LLM-Kontext entfernte Tokens über alle Sessions.
compressionDurchschnittlicher Prozentsatz entfernter Tokens. Höher = effizienter.
commandsGesamte vom Shell Hook komprimierte Shell-Befehle.
USD savedGeschätzte Kosteneinsparung basierend auf durchschnittlichen Token-Preisen ($2.50/1M Input-Tokens).
Top CommandsWelche CLI-Tools die meisten Tokens gespart haben, nach Gesamteinsparung sortiert.
30-day sparkline30-Tage-Trend der täglichen Einsparungsaktivität.

Live-Modus - lean-ctx gain --live

Automatisch aktualisierendes Dashboard, das alle 2 Sekunden aktualisiert wird.

$ 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

Wann verwenden: In einem Nebenterminal während Coding-Sessions ausführen, um Einsparungen in Echtzeit zu beobachten.

Diagramme & Tabellen

lean-ctx gain --graph

30-Tage-Einsparungsdiagramm mit täglichen Balken.

$ 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

Gerahmte Tages-Tabelle mit Spalten für gesparte Tokens, Kompressionsrate, Befehlsanzahl und 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-Dashboard - lean-ctx dashboard

Interaktives Browser-Dashboard unter http://localhost:3333.

lean-ctx dashboard              # default port 3333
lean-ctx dashboard --port=8080  # custom port

Dashboard-Panels

PanelInhalt
Statistik-ÜbersichtGesparte Tokens, Kompressionsrate, USD, Befehlsanzahl - gleiche Daten wie gain
MCP-AktivitätAktuelle MCP-Tool-Aufrufe, welche Tools am häufigsten verwendet werden, Antwortzeiten
Aktive AgentenÜber ctx_agent registrierte AI-Agenten. Zeigt Agentenname, Rolle, Status und Heartbeat.
ProjektwissenÜber ctx_knowledge gespeicherte Fakten, nach Kategorie gruppiert mit Konfidenzwerten.

API-Endpunkte

Das Dashboard bietet eine JSON-API, die du direkt abfragen kannst:

EndpunktDaten
GET /api/statsToken-Einsparungsstatistiken (gleich wie gain --json)
GET /api/mcpMCP-Tool-Nutzungsdaten
GET /api/agentsAktives Agenten-Register
GET /api/knowledgeProjektwissen-Speicher

Wrapped-Berichte - lean-ctx wrapped

"Spotify Wrapped" für deine Token-Einsparungen. Generiert eine teilbare Berichtskarte.

lean-ctx wrapped           # current week
lean-ctx wrapped --week    # current week (explicit)
lean-ctx wrapped --month   # current month
lean-ctx wrapped --all     # lifetime stats

Beispielausgabe

$ 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-Bericht - lean-ctx cep

Der Cognitive Efficiency Protocol-Bericht zeigt, wie lean-ctx das LLM-Reasoning optimiert.

$ 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

Exakte Token-Einsparungen auf echten Projektdateien mit tiktoken messen.

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]

Generiere einen Markdown-Bericht zum Teilen oder Committen.

lean-ctx benchmark report src/ > BENCHMARK.md

Der Bericht enthält Aufschlüsselungen pro Datei, Modusvergleiche und Gesamtstatistiken.

JSON-Export - lean-ctx gain --json

Exportiere alle Statistiken als JSON für Scripting, CI/CD-Integration oder eigene Dashboards.

lean-ctx gain --json > stats.json

Das JSON enthält:

  • Gesamte gesparte Tokens und Kompressionsrate
  • Aufschlüsselung pro Befehl (Name, Anzahl, gesparte Tokens)
  • Tagesverlauf (Datum, Gespart, Rate, Befehle)
  • USD-Schätzungen

Beispiel: Gesamteinsparungen in einem CI-Skript extrahieren:

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

USD-Berechnung

lean-ctx schätzt USD-Einsparungen basierend auf durchschnittlichen LLM-Input-Token-Preisen. Der Standardsatz beträgt $2.50 pro 1M Input-Tokens.

Die Formel lautet:

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

Dies ist eine konservative Schätzung - tatsächliche Einsparungen können bei teureren Modellen höher oder bei günstigeren Modellen niedriger ausfallen.