Seu guia rápido para uso diário. Para explicações detalhadas, siga os links para a página dedicada de cada seção.
Árvore de Decisão dos Modos de Leitura
Qual modo de ctx_read a IA deve usar?
| Situação | Modo | Economia típica |
|---|---|---|
| Arquivo que você vai editar | full | Re-reads: ~99% |
| Apenas contexto (dependências, estrutura) | map | ~93% |
| Superfície da API (assinaturas de funções/classes) | signatures | ~95% |
| Após editar um arquivo | diff | ~98% |
| Navegar em um arquivo grande | aggressive | ~85% |
| Arquivo muito grande, poucas linhas 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% |
Documentação completa do ctx_read →
Ferramentas de Contexto (o que a IA usa)
Essas são chamadas pela IA automaticamente - você não precisa digitá-las.
| Ferramenta | Finalidade | Economia |
|---|---|---|
ctx_read | Leitura de arquivo com compressão + cache | up to 99% |
ctx_shell | Execução de comando com compressão de saída | 60–95% |
ctx_search | Busca de código com resultados compactos | 50–80% |
ctx_session | Memória de sessão entre chats | 99% cold-start |
ctx_graph | Visualização do grafo de dependências | - |
ctx_smells | Code smell detection with graph scoring | - |
Referência completa das ferramentas →
Comandos CLI (o que você digita)
Essencial
| Comando | O que faz |
|---|---|
lean-ctx setup | Configuração única - detecta shell + ferramentas de IA, instala tudo |
lean-ctx gain | Painel de economia (--live, --graph, --daily) |
lean-ctx doctor | Diagnosticar problemas de instalação (8 verificações) |
lean-ctx dashboard | Painel web com gráficos (localhost:3333) |
lean-ctx knowledge <action> | Conhecimento do projeto: remember, recall, search, export, import, remove, status, health |
lean-ctx benchmark run [path] | Medição real de economia de tokens |