dekko
gerador rápido, offline e sem dependências de mapas de código estáticos e indexador de base de código para agentes de codificação de LLM.
Documentação
dekko é um gerador de mapa de código estático rápido, offline e sem dependências, além de um indexador de codebase para agentes de codificação LLM. Ele escaneia um repositório com tree-sitter (sem gastar tokens de modelo na análise) e escreve:
MAP.md— um mapa legível por humanos: uma visão geral por diretório, um diagrama de arquitetura embutido, rankings de arquivos críticos/orquestradores, e então as funções/métodos de cada arquivo com assinaturas, linhas de documentação, e quem chama e é chamado por quem.map.json— o mesmo grafo em formato legível por máquina.
Além do mapa, o dekko oferece ao agente uma forma barata em tokens de responder perguntas como "o que este arquivo contém", "quem chama esta função" e "o que preciso para alterar isso com segurança" — sem ler arquivos inteiros. Ele é distribuído como CLI, um plugin /map + servidor MCP para Claude Code (Model Context Protocol), e também funciona com Cline.
Por que dekko?
A maioria dos fluxos de trabalho de agentes coleta contexto lendo arquivos inteiros ou fazendo buscas em todo o repositório — algo caro e que descarta a estrutura (quem chama o quê, como é o fan-in/fan-out de uma função). O dekko, em vez disso, analisa o repositório uma vez em um grafo de chamadas e responde perguntas direcionadas com base nele. Medido em 7 repositórios open-source reais e não modificados (Go, TypeScript, Java, Rust, Python/C++ — até 14 mil arquivos), as consultas estruturadas do dekko usaram 3x–200x menos tokens do que o fluxo de trabalho equivalente de Read/Grep para a mesma tarefa (orientação no repositório, delineamento de um arquivo grande, rastreamento de chamadores/callees de um símbolo).
| Tarefa | Exemplo de repositório (escala) | dekko | Ler/Grep | Economia |
|---|---|---|---|---|
Orientação no repositório (summary) | awesome-go (10 arquivos) | 308 tok | ~15.271 tok | ~50x |
Orientação no repositório (summary) | cline (2.730 arquivos) | 1.202 tok | ~4.020 tok | ~3,3x |
| Delinear um arquivo grande | claude-code main.tsx (4.683 linhas) | 1.017 tok | 200.981 tok | ~197x |
| Delinear um arquivo grande | zed editor.rs (12.554 linhas) | 1.996 tok | 115.109 tok | ~58x |
Busca de símbolo (query_symbol + chamadores/callees) | classe Graph do tensorflow | ~811 tok | 61.656 tok | ~76x |
Busca de símbolo (query_symbol + chamadores/callees) | spring-boot prepareContext | 759 tok | ~18.460 tok | ~24x |
Contexto agrupado (workset) | zed | 2.984 tok | ~5.903+ tok (direcionado) / ~164.571 tok (arquivo inteiro) | ~2x / ~55x |
Contexto agrupado (workset) | awesome-go | 617 tok | ~6.136 tok | ~10x |
O custo do dekko permanece aproximadamente constante por consulta, enquanto Read/Grep escala com o tamanho do arquivo/repositório, então a proporção cresce com a escala. A vantagem não é universal — arquivos pequenos e autocontidos e símbolos locais já fáceis de buscar via grep apresentam pouco ou nenhum benefício, e alguns casos nos dados brutos são nulos porque a resposta barata também era incompleta. Veja benchmarks/real-world-repos/ para a análise completa por tarefa, metodologia e ressalvas de correção.
Comparado a ferramentas de índice de tags como ctags/gtags, o dekko resolve arestas de chamada reais (não apenas definições), classifica arquivos por importância estrutural e fala diretamente com agentes via MCP ou CLI — sem necessidade de plugin de editor.
Instalação
uv tool install dekko # or: pip install dekko / pipx install dekko
dekko --claude-install # add the /map command + MCP server to Claude Code, then restart
Extras (dekko[all] para ~55 idiomas adicionais, dekko[search] para busca por embeddings), instalação a partir de um clone local e desinstalação estão em docs/install.md.
Início rápido
cd my-project
dekko map # writes .dekko/MAP.md + .dekko/map.json
dekko summary # ~40-line digest: dirs, hotspots, entry points
.dekko/ é ignorado pelo git por padrão; o mapa é regenerado sob demanda, então raramente você precisará executar dekko map novamente manualmente.
Documentação
- docs/install.md — instalação, extras, clone local, desinstalação
- docs/cli.md — todos os comandos da CLI, alvos de símbolo, exclusão de arquivos, notas, modo daemon, suporte a idiomas
- docs/claude-code.md — o plugin
/map, hooks de push, habilidades do Claude Code, o servidor MCP e o Cline
Saiba mais
- CHANGELOG.md — histórico por versão
- CONTRIBUTING.md — configuração de desenvolvimento, testes, lançamentos
- benchmarks/ — medições de eficiência de tokens, incluindo uma comparação em 7 repositórios reais contra um fluxo de trabalho simples de Ler/Grep