Limitations
Connues
Nous croyons en une documentation honnête. Voici ce que lean-ctx fait bien - et où se trouvent ses limites.
Limites de Compression
Les économies de tokens varient selon le type de fichier, la complexité du contenu et le mode de lecture. Voici ce à quoi vous pouvez vous attendre en pratique.
Économies attendues par scénario
| Scénario | Économies |
|---|---|
| Première lecture (fichiers de code) | 60–95 % |
| Relecture en cache | Jusqu'à 99 % |
| Petits fichiers (<10 lignes) | Minimal |
| Fichiers binaires | Ignorés |
| Sortie Shell inconnue | Passée telle quelle |
Économies dépendantes du contenu
Les économies réelles dépendent de la densité du code, du ratio de commentaires et de la répétition. Un code bien structuré avec des signatures claires se compresse mieux que des one-liners denses sans commentaires.
Relectures en cache
Quand lean-ctx a déjà vu un fichier et qu'il n'a pas changé, les relectures coûtent environ 13 tokens quelle que soit la taille du fichier. C'est l'origine du chiffre de 99 %.
Support Linguistique
lean-ctx utilise tree-sitter pour la compression sensible à l'AST. La couverture varie selon le langage - voici le tableau complet.
Niveaux de support linguistique
| Niveau | Langages | Compression |
|---|---|---|
| AST complet | Rust, TypeScript, Python, Go, Java, C, C++, C#, Ruby, PHP, Swift, Kotlin, Scala, Lua, Zig, Elixir, Haskell, OCaml | Élagage sensible aux signatures |
| Basique | Tous les autres langages | Compression ligne par ligne |
Le niveau basique offre quand même une compression significative - il ne peut simplement pas extraire les signatures de fonctions ni élaguer les nœuds AST. La plupart des fichiers voient encore 40–70 % d'économies grâce à la déduplication et au filtrage d'entropie.
Contraintes d'Architecture
lean-ctx est conçu avec des compromis architecturaux spécifiques. Les comprendre aide à définir les bonnes attentes.
Prérequis MCP
lean-ctx fonctionne comme serveur MCP. Votre agent IA doit supporter le Model Context Protocol.
Compatible avec : Claude Code, Cursor, Codex, Gemini CLI et plus.
Portée d'un seul projet
Chaque instance lean-ctx est limitée à un répertoire racine de projet. Les flux multi-dépôts nécessitent des instances séparées.
Solution : exécuter une instance par dépôt dans votre espace de travail.
Mise à l'échelle mémoire
Le cache en mémoire grandit avec votre projet. Les très grands monorepos (100 000+ fichiers) peuvent bénéficier d'un ajustement des limites de cache.
Configurable via les paramètres lean-ctx.
Pas un Remplacement
lean-ctx optimise la façon dont le contexte est livré au LLM. Il ne remplace pas les fondamentaux de la bonne ingénierie.
- Les bonnes pratiques de prompting - des instructions claires et précises restent importantes
- Une bonne organisation du code - un code bien structuré se compresse mieux
- Le contrôle de version - lean-ctx ne gère pas les modifications de code ni l'historique
lean-ctx optimise la livraison, ne remplace pas les fondamentaux.
Découvrez ce que lean-ctx peut faire
Maintenant que vous connaissez les limites, explorez ce que lean-ctx offre en leur sein - garanties de sécurité, benchmarks de performance et comparaisons.