Tu hoja de referencia rápida para el uso diario. Para explicaciones detalladas, sigue los enlaces a la página dedicada de cada sección.
Árbol de decisión de modos de lectura
¿Qué modo de ctx_read debería usar la IA?
| Situación | Modo | Ahorro típico |
|---|---|---|
| Archivo que vas a editar | full | Re-reads: ~99% |
| Solo contexto (dependencias, estructura) | map | ~93% |
| Superficie de API (firmas de funciones/clases) | signatures | ~95% |
| Después de editar un archivo | diff | ~98% |
| Explorar un archivo grande | aggressive | ~85% |
| Archivo muy grande, pocas líneas relevantes | entropy | ~90% |
| Task-relevant lines only | task | ~77% |
| API docs and reference lookup | reference | ~80-95% |
| Specific line range (surgical) | lines:N-M | ~90-99% |
| Automatic (default - best mode per file) | auto | ~70-99% |
Documentación completa de ctx_read →
Herramientas de contexto (lo que usa la IA)
Estas son llamadas automáticamente por la IA - no necesitas escribirlas.
| Herramienta | Propósito | Ahorro |
|---|---|---|
ctx_read | Lectura de archivos con compresión + caché | up to 99% |
ctx_shell | Ejecución de comandos con compresión de salida | 60–95% |
ctx_search | Búsqueda de código con resultados compactos | 50–80% |
ctx_session | Memoria de sesión entre conversaciones | 99% cold-start |
ctx_graph | Visualización del grafo de dependencias | - |
ctx_smells | Code smell detection with graph scoring | - |
Referencia completa de herramientas →
Comandos CLI (lo que escribes)
Esencial
| Comando | Qué hace |
|---|---|
lean-ctx setup | Configuración inicial - detecta shell + herramientas de IA, instala todo |
lean-ctx gain | Panel de ahorros (--live, --graph, --daily) |
lean-ctx doctor | Diagnosticar problemas de instalación (8 verificaciones) |
lean-ctx dashboard | Panel web con gráficos (localhost:3333) |
lean-ctx knowledge <action> | Conocimiento del proyecto: remember, recall, search, export, import, remove, status, health |
lean-ctx benchmark run [path] | Medición real de ahorro de tokens |