Limitaciones
Conocidas
Creemos en la documentación honesta. Aquí está lo que lean-ctx hace bien - y dónde están sus límites.
Límites de Compresión
El ahorro de tokens varía según el tipo de archivo, la complejidad del contenido y el modo de lectura. Esto es lo que puedes esperar en la práctica.
Ahorro esperado por escenario
| Escenario | Ahorro |
|---|---|
| Primera lectura (archivos de código) | 60–95% |
| Relectura desde caché | Hasta 99% |
| Archivos pequeños (<10 líneas) | Mínimo |
| Archivos binarios | Omitidos |
| Salida Shell desconocida | Pasa tal cual |
Ahorro dependiente del contenido
El ahorro real depende de la densidad del código, la proporción de comentarios y la repetición. El código bien estructurado con firmas claras se comprime mejor que los one-liners densos sin comentarios.
Relecturas desde caché
Cuando lean-ctx ya ha visto un archivo y no ha cambiado, las relecturas cuestan aproximadamente 13 tokens independientemente del tamaño del archivo. Este es el origen del dato del 99%.
Soporte de Lenguajes
lean-ctx utiliza tree-sitter para compresión con reconocimiento de AST. La cobertura varía según el lenguaje - aquí está el panorama completo.
Niveles de soporte de lenguajes
| Nivel | Lenguajes | Compresión |
|---|---|---|
| AST completo | Rust, TypeScript, Python, Go, Java, C, C++, C#, Ruby, PHP, Swift, Kotlin, Scala, Lua, Zig, Elixir, Haskell, OCaml | Poda consciente de firmas |
| Básico | Todos los demás lenguajes | Compresión por líneas |
El nivel básico aún ofrece compresión significativa - simplemente no puede extraer firmas de funciones ni podar nodos AST. La mayoría de los archivos aún ven un ahorro del 40–70% mediante deduplicación y filtrado de entropía.
Restricciones de Arquitectura
lean-ctx está diseñado con compromisos arquitectónicos específicos. Entenderlos ayuda a establecer las expectativas correctas.
Requisito MCP
lean-ctx funciona como servidor MCP. Tu agente de IA debe soportar el Model Context Protocol.
Compatible con: Claude Code, Cursor, Codex, Gemini CLI y más.
Alcance de proyecto único
Cada instancia lean-ctx está limitada a un directorio raíz de proyecto. Los flujos multi-repositorio requieren instancias separadas.
Solución: ejecutar una instancia por repositorio en tu espacio de trabajo.
Escalado de memoria
La caché en memoria crece con tu proyecto. Los monorepos muy grandes (100.000+ archivos) pueden beneficiarse de ajustar los límites de caché.
Configurable mediante ajustes de lean-ctx.
No es un Reemplazo
lean-ctx optimiza cómo se entrega el contexto al LLM. No reemplaza los fundamentos de la buena ingeniería.
- Buenas prácticas de prompting - las instrucciones claras y específicas siguen siendo importantes
- Organización adecuada del código - el código bien estructurado se comprime mejor
- Control de versiones - lean-ctx no gestiona cambios de código ni historial
lean-ctx optimiza la entrega, no reemplaza los fundamentos.
Descubre lo que lean-ctx puede hacer
Ahora que conoces los límites, explora lo que lean-ctx ofrece dentro de ellos - garantías de seguridad, benchmarks de rendimiento y comparaciones.