CodeGraph: Grafo de conhecimento para agentes de código¶
O CodeGraph é um grafo de conhecimento pré‑indexado que fornece inteligência semântica sobre o código‑fonte para agentes de codificação baseados em IA. Ele permite que ferramentas como Claude Code, Cursor e Codex trabalhem com menos tokens e menos chamadas de ferramenta, tudo de forma 100% local.
Visão geral¶
O projeto disponibiliza um pacote npm que contém todo o conhecimento necessário para que os agentes compreendam estruturas de código, chamadas de função e dependências sem precisar fazer consultas externas a APIs ou serviços de nuvem. Isso resulta em respostas mais rápidas e custos reduzidos de processamento.
Benefícios principais¶
| Métrica | Melhoria |
|---|---|
| Custo de tokens | ~16% mais barato |
| Chamadas de ferramenta | ~58% a menos |
| Execução | 100% local |
Observação
O CodeGraph é distribuído como o pacote @colbymchenry/codegraph no registro npm.
Dica
Para integrar em projetos existentes, basta instalar o pacote e configurar o agente para apontar para o grafo local.
Atenção
Embora a execução seja totalmente local, o primeiro download do grafo pode consumir alguns megabytes de banda de rede.
Plataformas e agentes suportados¶
- Sistemas operacionais: Windows, macOS, Linux
- Agentes de IA: Claude Code, Cursor, Codex, OpenCode, Hermes Agent, Gemini, Antigravity, Kiro
Instalação¶
Licença¶
O código é liberado sob a licença MIT, permitindo uso comercial e modificação sem restrições significativas.
Pontos-chave¶
- Fornece um grafo de conhecimento pré‑indexado para agentes de codificação IA.
- Reduz o consumo de tokens em ~16% e as chamadas de ferramenta em ~58%.
- Opera totalmente local, sem dependência de serviços externos.
- Suporta Windows, macOS, Linux e diversos agentes como Claude Code e Cursor.
- Distribuído via npm sob licença MIT, sem dependências adicionais.
Ferramentas e Tecnologias¶
- [[Claude Code]]
- [[Cursor]]
- [[Codex]]
- [[OpenCode]]
- [[Hermes Agent]]
- [[Gemini]]
- [[Antigravity]]
- [[Kiro]]
- [[npm]]
Nota pessoal
https://github.com/colbymchenry/codegraph