O que é CodeGraph?
O CodeGraph analisa um repositório e o transforma em um grafo SQLite local de símbolos, chamadas, imports e herança, que depois serve a agentes de código via MCP. Por padrão, o servidor lista uma única ferramenta, codegraph_explore, que devolve em uma só chamada o código-fonte relevante agrupado por arquivo, os caminhos de chamada entre símbolos e um resumo do raio de impacto. Sete ferramentas mais específicas (node, search, callers, callees, impact, files, status) continuam disponíveis pela variável de ambiente CODEGRAPH_MCP_TOOLS ou como comandos de CLI, e codegraph affected lista os arquivos de teste que um diff atinge.
A análise roda em um núcleo Rust para 20 linguagens, com 34 listadas no total, de TypeScript e Python a COBOL, Terraform e Nix, e detecção de rotas para 17 frameworks web. Um observador de arquivos atualiza o grafo cerca de dois segundos depois de cada salvamento, e nenhum LLM ou chave de API está envolvido. codegraph install configura nove agentes, entre eles Claude Code, Cursor, Codex CLI, Gemini CLI e GitHub Copilot; codegraph init indexa cada projeto.
O repositório, criado em janeiro de 2026, tem cerca de 75.400 estrelas e licença MIT. A versão mais recente é a v1.6.2, de 3 de outubro de 2026, e o pacote npm registrou cerca de 77.000 downloads na semana até 22 de outubro. Um produto hospedado de análise de pull requests está em lista de espera em getcodegraph.com, sem preços publicados.
Como instalar CodeGraph
npx @colbymchenry/codegraph && codegraph initCodeGraph vale a pena?
O CodeGraph resolve o problema que mina a maioria dos grafos de código: eles ficam desatualizados. O observador ressincroniza os arquivos alterados cerca de dois segundos depois de um salvamento, as respostas das ferramentas sinalizam qualquer arquivo ainda aguardando sincronização, e um servidor que se reconecta recupera as edições feitas enquanto estava desligado, como um git pull. O GitNexus precisa de --watch ou do plano enterprise para isso, e o Graphify, avaliado em repos, fica desatualizado depois de um pull até você rodar uma atualização.
O benchmark do mantenedor é incomumente cuidadoso para um autorrelatado. O Claude Opus 4.8 respondeu a uma pergunta de arquitetura em cada um de sete repositórios de código aberto, quatro execuções por braço, com a CLI do codegraph bloqueada nos dois braços depois que uma versão anterior do teste deixou o braço de controle alcançá-la em 26 de 28 execuções. As medianas: 88% menos chamadas de ferramentas, 62% menos tokens e custo 44% menor. A dispersão importa mais que a média. No VS Code, o agente fez 2 chamadas em vez de 28 e gastou US$ 0,53 em vez de US$ 1,80; no Gin, um projeto Go pequeno, o custo empatou em US$ 0,31. O README também admite o efeito oposto: as respostas densas do CodeGraph deixam cerca de 80% mais texto recuperado na janela de contexto ao fim de uma sessão, 67.000 tokens contra 18.000 no VS Code.
A superfície estreita é proposital. Uma única ferramenta listada orienta melhor os agentes do que um menu, argumenta o mantenedor, e ela é somente leitura, então nada no servidor MCP edita código. Isso também significa nenhum rename com prévia, nenhuma consulta bruta ao grafo e nenhum fluxo de dados no nível de instrução, tudo o que o GitNexus oferece. O GitNexus lê com mais profundidade; a licença MIT do CodeGraph permite que uma empresa o use hoje, enquanto o GitNexus exige um acordo comercial até para um piloto.
Dois padrões merecem atenção. A telemetria anônima de uso fica ativa a menos que você a desligue no instalador, com codegraph telemetry off ou com DO_NOT_TRACK=1; os campos documentados excluem código, caminhos e consultas. O instalador também grava a configuração MCP, permissões de aprovação automática para o Claude Code e uma seção delimitada por marcadores no CLAUDE.md ou no AGENTS.md. Os agentes nem sempre o usam: uma issue de julho relata o Claude Code fazendo grep mesmo assim, e a solução é a configuração alwaysLoad, que agora está no README.
O projeto lança rápido e tem uma fila à altura: cerca de 140 issues abertas e 400 pull requests abertos. O visualizador codegraph ui aparece na documentação, mas usuários da 1.6.0 relatam "unknown command" em uma issue aberta desde setembro. Uma busca no registro oficial do MCP encontra outros projetos chamados CodeGraph e nenhum deste repositório, então confira o nome no npm, @colbymchenry/codegraph, antes de instalar.
Onde ele se destaca
Um desenvolvedor backend em um monorepo TypeScript de 11.000 arquivos
Impedir que o agente faça grep em dezenas de arquivos antes de conseguir explicar um fluxo
Rode npx @colbymchenry/codegraph uma vez, depois codegraph init no repositório, e defina alwaysLoad para que o Claude Code veja codegraph_explore desde o primeiro prompt. No benchmark do VS Code do README, isso reduziu uma pergunta de 28 chamadas de ferramentas para 2; preveja o maior consumo de contexto em sessões longas.
Um engenheiro de plataforma em uma empresa SaaS com 30 desenvolvedores
Rodar no CI apenas os testes que uma mudança pode afetar
Encaminhe git diff --name-only para codegraph affected --stdin --quiet e passe o resultado ao executor de testes. Por padrão ele segue imports até profundidade 5, então testes alcançados por injeção de dependência ou reflexão podem escapar; mantenha uma execução completa noturna.
Uma gerente de engenharia implantando um agente em toda a equipe
Dar a todos os desenvolvedores o mesmo contexto de código sem negociar licença
MIT significa nenhum acordo comercial, ao contrário do GitNexus. Use codegraph install --yes na imagem do dev container e defina CODEGRAPH_TELEMETRY=0 ali se estatísticas de uso saindo das máquinas da empresa forem uma preocupação. O produto hospedado de PRs só tem lista de espera, então não há contrato com fornecedor para assinar nem preço para comparar.
Antes de decidir
- Configuração
- O instalador para shell ou PowerShell traz o próprio runtime, ou npm i -g @colbymchenry/codegraph; codegraph install configura Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity, Kiro e GitHub Copilot, e depois codegraph init constrói o grafo de cada projeto. O README estima cerca de 100 segundos para indexar do zero o repositório do compilador Swift, com 27.000 arquivos.
- Integrações
- Uma ferramenta MCP por padrão (codegraph_explore) via stdio; node, search, callers, callees, impact, files e status voltam com CODEGRAPH_MCP_TOOLS. Todas são somente leitura. As mesmas funções existem como comandos de CLI e como uma API Node (Node 22.5+ quando embutido).
- Dados e privacidade
- O código, o grafo e as buscas ficam locais em .codegraph/codegraph.db. A telemetria envia contagens diárias de comandos, agentes e linguagens indexadas, a menos que seja desativada, e o servidor consulta o GitHub em busca de uma nova versão uma vez por dia. Não há avisos de segurança publicados; os pacotes npm e os bundles de versão têm atestados de proveniência desde julho de 2026.
- Custo em escala
- Gratuito; o custo é tempo de máquina. O README relata que o kernel do Linux (70.000 arquivos) é indexado em menos de 12 minutos em uma VPS de 2 núcleos e 6 GB, e que uma edição em um arquivo é ressincronizada em cerca de 4 segundos no repositório do Swift. Sem taxas de hospedagem até que a plataforma em lista de espera defina preços.
- Limites
- Arquivos acima de 1 MB e caminhos no gitignore são ignorados. A análise estática não enxerga dispatch em tempo de execução nem reflexão: a cobertura entre arquivos é de 73,8% para Liquid e 83,3% para rotas Spring. Projetos WSL2 em drives /mnt têm problemas de socket e de travamento, e só é permitido um gravador por projeto.
O que é bom
- O grafo se ressincroniza cerca de dois segundos depois de cada salvamento
- Licença MIT; nenhum LLM, chave de API ou serviço de rede para indexar
- Superfície MCP somente leitura com uma única ferramenta por padrão
- Benchmark autorrelatado cuidadoso, inclusive sobre onde gasta mais contexto
O que não é
- Telemetria anônima ativada por padrão
- Sem rename, consultas brutas ou análise de fluxo de dados, ao contrário do GitNexus
- As respostas deixam mais texto na janela de contexto em sessões longas
- Cerca de 400 pull requests abertos; o comando ui documentado não está nas versões
Ideal para
Equipes que querem que o agente de código responda a partir de um grafo local sempre atualizado, sob uma licença que o empregador aceite.
Alternativas ao CodeGraph
CodeGraph: perguntas frequentes
- CodeGraph vale a pena?
- Um grafo de código que se mantém atualizado sozinho e que uma empresa pode adotar sob MIT, embora leia com menos profundidade que o GitNexus e envie dados para casa a menos que você diga para não enviar. Damos nota 4.1 de 5.
- Quanto custa CodeGraph?
- Gratuito e com licença MIT. Uma plataforma hospedada de análise de pull requests está em beta com lista de espera em getcodegraph.com; os preços não são publicados.
- Quais são as desvantagens de CodeGraph?
- Telemetria anônima ativada por padrão; sem rename, consultas brutas ou análise de fluxo de dados, ao contrário do GitNexus; as respostas deixam mais texto na janela de contexto em sessões longas; cerca de 400 pull requests abertos; o comando ui documentado não está nas versões.
- Para quem CodeGraph é indicado?
- Equipes que querem que o agente de código responda a partir de um grafo local sempre atualizado, sob uma licença que o empregador aceite.
- Quanto custa CodeGraph para uma equipe ou em produção?
- Gratuito; o custo é tempo de máquina. O README relata que o kernel do Linux (70.000 arquivos) é indexado em menos de 12 minutos em uma VPS de 2 núcleos e 6 GB, e que uma edição em um arquivo é ressincronizada em cerca de 4 segundos no repositório do Swift. Sem taxas de hospedagem até que a plataforma em lista de espera defina preços.
- CodeGraph é seguro para dados da empresa?
- O código, o grafo e as buscas ficam locais em .codegraph/codegraph.db. A telemetria envia contagens diárias de comandos, agentes e linguagens indexadas, a menos que seja desativada, e o servidor consulta o GitHub em busca de uma nova versão uma vez por dia. Não há avisos de segurança publicados; os pacotes npm e os bundles de versão têm atestados de proveniência desde julho de 2026.
- Quais são as melhores alternativas ao CodeGraph?
- As alternativas mais próximas que analisamos são GitNexus, code-review-graph, Serena, Semble e Project RAG.
Respostas verificadas em 26 de out. de 2026.