Referencia CLI

Comandos para humanos.
Resultados para IA.

lean-ctx funciona automáticamente después de la configuración. Pero cuando quieras control, estos comandos están disponibles.

Lo esencial

Comandos Esenciales

lean-ctx setup

Configuración única. Detecta automáticamente tu shell (zsh/bash/fish), encuentra herramientas de IA instaladas, configura MCP y shell hooks. Ejecuta una vez, no vuelvas a pensar en ello.

Ejecutar una vez después de instalar
lean-ctx init

Configuración rápida para una herramienta de IA específica. Usa --agent cursor, --agent claude, --agent codex, o --agent gemini para configurar MCP directamente para esa herramienta.

Alternativa por agente al setup
lean-ctx gain

Consulta tu panel de ahorros. Tokens ahorrados de por vida, tasas de compresión, comandos principales y estimaciones de costos en USD. Persistente entre sesiones.

Consulta en cualquier momento
Conoce exactamente lo que ahorras

Monitoreo e Información

lean-ctx gain

Panel de ahorros acumulados con conteos de tokens, tasa de compresión, comandos principales y seguimiento de costos en USD.

$ lean-ctx gain

◆ lean-ctx Token Savings Dashboard

────────────────────────────────

1.7M saved 76.8% rate $4.25 USD

Top Commands

curl 48x ████████████ 728K

git 34x ██████ 375K

lean-ctx gain --live

Panel en vivo con actualización automática. Se actualiza cada 2 segundos mientras tus herramientas de IA ahorran tokens en tiempo real.

● LIVE

$ lean-ctx gain --live

◆ lean-ctx LIVE refreshing every 2s

────────────────────────────────

1.7M saved ▁▃█▇██▁█

Session: 42 cmds | 89.2K saved | 94.1% rate

Press q to quit

lean-ctx gain --graph

Gráfico de ahorros de 30 días con barras diarias, sparklines y visualización de tendencias. Observa la trayectoria de tus ahorros.

$ 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 dashboard

Panel web en localhost:3333. Gráficos interactivos, historial de sesiones y monitoreo en tiempo real en tu navegador.

$ lean-ctx dashboard

◆ lean-ctx Dashboard

→ http://localhost:3333

Interactive charts, session history, command breakdown

Press Ctrl+C to stop

lean-ctx wrapped

"Spotify Wrapped" de tus ahorros de tokens. Reportes hermosos y compartibles con tus estadísticas de por vida, comandos principales y logros de compresión personales.

weekly monthly lifetime

$ lean-ctx wrapped monthly

◆ 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

Verificar y optimizar

Diagnósticos

lean-ctx doctor

Ejecuta 8 verificaciones de instalación - binario, shell hook, configuración MCP, archivo de estadísticas, directorio de cache, shell compatible, detección de herramientas de IA y verificación de versión.

Binary installed

Shell hook active (zsh)

MCP config (Cursor)

Stats persistence

Cache directory

Data directory writable

Project detection

Graph index

Search index

Agent hooks

Version up to date

All 11 checks passed

lean-ctx discover

Escanea tu historial de shell en busca de comandos que podrían beneficiarse de la compresión pero que aún no se interceptan.

Found 12 uncompressed commands:

kubectl - 34 calls, ~89% savings possible

helm - 12 calls, ~76% savings possible

terraform - 8 calls, ~82% savings possible

Run setup to enable these

lean-ctx benchmark run

Mide los ahorros reales de tokens en tu código usando tiktoken (o200k_base). Números exactos, sin estimaciones.

src/auth.ts (123 lines)

full: 3,517 → 3,517 (0%)

map: 3,517 → 412 (88%)

signatures: 3,517 → 252 (93%)

entropy: 3,517 → 312 (91%)

Control total

Comandos para Usuarios Avanzados

Comando Descripción
lean-ctx init --agent <name> Configuración rápida de MCP para una herramienta de IA específica (cursor, claude, codex, gemini, windsurf, copilot, cline, roo, pi, qwen, trae, amazonq, jetbrains)
lean-ctx read <file> -m <mode> Lee cualquier archivo con un modo de compresión (full, map, signatures, diff, aggressive, entropy). Las lecturas en caché devuelven ~13 tokens. Use --fresh para omitir la caché.
lean-ctx diff Git diff comprimido - salida estructurada con resúmenes de cambios
lean-ctx grep <pattern> Búsqueda de patrones eficiente en tokens con contexto compacto
lean-ctx find <pattern> Buscar archivos por nombre - resultados compactos con conteo de archivos
lean-ctx ls Listado de directorio como mapa de árbol compacto
lean-ctx -c "<cmd>" Comprime la salida de cualquier comando de shell a través de lean-ctx
lean-ctx config set <key> <value> Configura los ajustes de lean-ctx - intervalos de checkpoint, TTL de cache, modo CRP
lean-ctx cache [stats|clear|invalidate] Gestionar la caché CLI - ver estadísticas, limpiar entradas o invalidar rutas específicas
lean-ctx setup Configuración con un comando - configura hooks de shell, MCP del editor y verifica que todo funcione

¿Listo para ver tus ahorros?

Instala lean-ctx, ejecuta setup y comienza a ahorrar tokens de inmediato. Revisa tu panel con gain cuando quieras.