Limitações
Conhecidas
Acreditamos em documentação honesta. Veja o que o lean-ctx faz bem - e onde estão seus limites.
Limites de Compressão
A economia de tokens varia por tipo de arquivo, complexidade do conteúdo e modo de leitura. Veja o que esperar na prática.
Economia esperada por cenário
| Cenário | Economia |
|---|---|
| Primeira leitura (arquivos de código) | 60–95% |
| Releitura em cache | Até 99% |
| Arquivos pequenos (<10 linhas) | Mínimo |
| Arquivos binários | Ignorados |
| Saída Shell desconhecida | Passada como está |
Economia dependente do conteúdo
A economia real depende da densidade do código, proporção de comentários e repetição. Código bem estruturado com assinaturas claras comprime melhor que one-liners densos sem comentários.
Releituras em cache
Quando o lean-ctx já leu um arquivo e ele não mudou, releituras custam aproximadamente 13 tokens independente do tamanho do arquivo. Esta é a origem do dado de 99%.
Suporte a Linguagens
O lean-ctx usa tree-sitter para compressão com reconhecimento de AST. A cobertura varia por linguagem - veja o panorama completo.
Níveis de suporte a linguagens
| Nível | Linguagens | Compressão |
|---|---|---|
| AST completo | Rust, TypeScript, Python, Go, Java, C, C++, C#, Ruby, PHP, Swift, Kotlin, Scala, Lua, Zig, Elixir, Haskell, OCaml | Poda consciente de assinaturas |
| Básico | Todas as outras linguagens | Compressão por linhas |
O nível básico ainda oferece compressão significativa - apenas não consegue extrair assinaturas de funções ou podar nós AST. A maioria dos arquivos ainda vê economia de 40–70% por deduplicação e filtragem de entropia.
Restrições de Arquitetura
O lean-ctx é projetado com compromissos arquiteturais específicos. Entendê-los ajuda a definir as expectativas corretas.
Requisito MCP
O lean-ctx funciona como servidor MCP. Seu agente de IA deve suportar o Model Context Protocol.
Compatível com: Claude Code, Cursor, Codex, Gemini CLI e mais.
Escopo de projeto único
Cada instância lean-ctx é limitada a um diretório raiz de projeto. Fluxos multi-repositório requerem instâncias separadas.
Solução: executar uma instância por repositório no seu workspace.
Escalamento de memória
O cache em memória cresce com seu projeto. Monorepos muito grandes (100.000+ arquivos) podem se beneficiar do ajuste dos limites de cache.
Configurável via configurações do lean-ctx.
Não é um Substituto
O lean-ctx otimiza como o contexto é entregue ao LLM. Não substitui os fundamentos da boa engenharia.
- Boas práticas de prompting - instruções claras e específicas continuam sendo importantes
- Organização adequada do código - código bem estruturado comprime melhor
- Controle de versão - o lean-ctx não gerencia alterações de código nem histórico
O lean-ctx otimiza a entrega, não substitui os fundamentos.
Veja o que o lean-ctx pode fazer
Agora que você conhece os limites, explore o que o lean-ctx oferece dentro deles - garantias de segurança, benchmarks de desempenho e comparações.