lean-ctx rastrea cada token que ahorra en todas las sesiones. Esta guía explica cómo acceder, interpretar y compartir tus datos de ahorro a través de paneles de terminal, interfaz web, reportes wrapped y benchmarks.
Todos los datos se almacenan localmente en ~/.lean-ctx/stats.json y persisten entre sesiones y reinicios.
Panel de terminal - lean-ctx gain
La forma principal de consultar tus ahorros. Ejecuta lean-ctx gain en cualquier terminal para ver un panel visual con colores, barras, sparklines y estimaciones 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: ▁▃▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁Qué significan los números
| Métrica | Significado |
|---|---|
| tokens saved | Total de tokens eliminados del contexto del LLM en todas las sesiones. |
| compression | Porcentaje promedio de tokens eliminados. Mayor = más eficiente. |
| commands | Total de comandos de shell comprimidos por el shell hook. |
| USD saved | Ahorro estimado en costos basado en el precio promedio de tokens ($2.50/1M tokens de entrada). |
| Top Commands | Qué herramientas CLI ahorraron más tokens, clasificadas por ahorro total. |
| 30-day sparkline | Tendencia visual de 30 días de la actividad diaria de ahorro. |
Modo en vivo - lean-ctx gain --live
Panel con actualización automática que se refresca cada 2 segundos.
$ 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 quitCuándo usar: Ejecútalo en una terminal secundaria durante las sesiones de programación para monitorear los ahorros en tiempo real.
Gráficos y tablas
lean-ctx gain --graph
Gráfico de ahorros de 30 días con barras diarias.
$ 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
Tabla diaria con bordes que incluye columnas de tokens ahorrados, tasa de compresión, cantidad de comandos y 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 │
└────────────┴──────────┴───────┴──────┴────────┘Panel web - lean-ctx dashboard
Panel interactivo basado en navegador en http://localhost:3333.
lean-ctx dashboard # default port 3333
lean-ctx dashboard --port=8080 # custom portPaneles del dashboard
| Panel | Contenido |
|---|---|
| Resumen de estadísticas | Total de tokens ahorrados, tasa de compresión, USD, cantidad de comandos - los mismos datos que gain |
| Actividad MCP | Llamadas recientes a herramientas MCP, herramientas más usadas, tiempos de respuesta |
| Agentes activos | Agentes de IA registrados actualmente vía ctx_agent. Muestra nombre del agente, rol, estado y latido. |
| Conocimiento del proyecto | Datos almacenados vía ctx_knowledge, agrupados por categoría con puntuaciones de confianza. |
Endpoints de API
El panel expone una API JSON que puedes consultar directamente:
| Endpoint | Datos |
|---|---|
GET /api/stats | Estadísticas de ahorro de tokens (igual que gain --json) |
GET /api/mcp | Datos de uso de herramientas MCP |
GET /api/agents | Registro de agentes activos |
GET /api/knowledge | Almacén de conocimiento del proyecto |
Reportes Wrapped - lean-ctx wrapped
"Spotify Wrapped" de tus ahorros de tokens. Genera una tarjeta de reporte compartible.
lean-ctx wrapped # current week
lean-ctx wrapped --week # current week (explicit)
lean-ctx wrapped --month # current month
lean-ctx wrapped --all # lifetime statsEjemplo de salida
$ 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)Reporte CEP - lean-ctx cep
El reporte del Cognitive Efficiency Protocol muestra cómo lean-ctx optimiza el razonamiento del 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
Mide los ahorros exactos de tokens en archivos reales del proyecto usando 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]
Genera un reporte en Markdown que puedes compartir o agregar a tu repositorio.
lean-ctx benchmark report src/ > BENCHMARK.mdEl reporte incluye desgloses por archivo, comparaciones de modos y estadísticas agregadas.
Exportación JSON - lean-ctx gain --json
Exporta todas las estadísticas como JSON para scripting, integración con CI/CD o paneles personalizados.
lean-ctx gain --json > stats.jsonEl JSON incluye:
- Total de tokens ahorrados y tasa de compresión
- Desglose por comando (nombre del comando, cantidad, tokens ahorrados)
- Historial diario (fecha, ahorrado, tasa, comandos)
- Estimaciones en USD
Ejemplo: extraer ahorros totales en un script de CI:
SAVED=$(lean-ctx gain --json | jq '.total_saved')
echo "lean-ctx saved $SAVED tokens this session"Cálculo en USD
lean-ctx estima los ahorros en USD basándose en el precio promedio de tokens de entrada de LLM. La tarifa predeterminada es $2.50 por 1M de tokens de entrada.
La fórmula es:
USD saved = (tokens saved / 1,000,000) × $2.50Esta es una estimación conservadora - los ahorros reales pueden ser mayores si usas modelos más costosos o menores si usas modelos más económicos.