CLI de busca semântica de código baseada em AST e servidor MCP que indexa sua base de código para que agentes de programação encontrem código pelo significado.
Jakedismo/codegraph-rust
Ferramenta em Rust que cria um grafo semântico da base de código e oferece ferramentas de análise agentic a agentes de programação via MCP.
- Estrelas
- 913
- Forks
- 98
- Issues abertas
- 17
- Último commit
- há 25 dias
O que é?
O CodeGraph indexa um projeto em um grafo de conhecimento composto por nós e arestas, combinando análise de AST, resolução opcional de símbolos via language server, vinculação de módulos e embeddings. O grafo fica armazenado em um banco SurrealDB embarcado no diretório .codegraph de cada projeto, sem necessidade de um servidor de banco de dados separado.
A ferramenta foi projetada para assistentes de programação com IA, como Claude Code, Cursor e Codex. Quatro ferramentas agentic consolidadas (context, impact, architecture e quality) executam um agente de raciocínio sobre o grafo e retornam uma resposta com caminhos de arquivos, números de linha e trechos limitados, em vez de uma lista bruta de resultados de busca. A indexação é feita em níveis (fast, balanced e full), permitindo equilibrar velocidade e armazenamento com a riqueza do grafo.
A busca combina similaridade vetorial com correspondência lexical e reranking opcional. O projeto também limita a quantidade de saída das ferramentas que chega ao modelo em cada execução e oferece suporte a vários provedores de embeddings e LLMs, incluindo Ollama, LM Studio, Jina, OpenAI e Anthropic.
Recursos principais
- 01Cria um grafo de conhecimento com nós de código, arestas, módulos e relações de fluxo de dados.
- 02Oferece quatro ferramentas agentic via MCP para analisar contexto, impacto de mudanças, arquitetura e qualidade.
- 03Oferece níveis de indexação fast, balanced e full, com resolução LSP opcional.
- 04Armazena os dados em um SurrealDB embarcado por projeto, sem exigir um servidor separado.
- 05Combina busca vetorial e lexical com reranking opcional.
- 06Respeita o .gitignore e filtra padrões comuns de arquivos secretos durante a indexação.
Casos de uso
- Fornecer contexto do projeto ao Claude Code ou Cursor antes de refatorar uma base de código grande.
- Estimar o que pode ser afetado quando uma função, um tipo ou um módulo muda.
- Entender a arquitetura ou encontrar pontos de alta complexidade em um projeto Rust desconhecido.
- Executar modelos de embeddings locais e auto-hospedados para manter o código-fonte na própria máquina.
Início rápido
- 1
Siga o Installation Guide (docs/INSTALLATION_GUIDE.md) para instalar o CodeGraph
- 2
Indexe seu projeto com o nível balanced
codegraph index /path/to/project --index-tier balanced - 3
Faça uma pergunta pela linha de comando
codegraph agent context "your question"
Antes de usar
- Os níveis de indexação balanced e full exigem a instalação de servidores de linguagem externos, como rust-analyzer, node ou gopls.
- A indexação tem muitas opções de configuração e variáveis de ambiente, então a configuração exige algum esforço.
Em coleções
Tópicos
Perguntas frequentes
- O que é codegraph-rust?
- Ferramenta em Rust que cria um grafo semântico da base de código e oferece ferramentas de análise agentic a agentes de programação via MCP. O CodeGraph indexa um projeto em um grafo de conhecimento composto por nós e arestas, combinando análise de AST, resolução opcional de símbolos via language server, vinculação de módulos e embeddings. O grafo fica armazenado em um banco SurrealDB embarcado no diretório .codegraph de cada projeto, sem necessidade de um servidor de banco de dados separado.
- codegraph-rust é gratuito? Qual é a licença?
- codegraph-rust não declara licença. O código é público, mas sem licença você não tem permissão explícita para reutilizá-lo; fale com o autor antes de depender dele.
- codegraph-rust ainda é mantido?
- Manutenção ativa. O último commit de codegraph-rust foi em 12 de out. de 2026.
- Para que posso usar codegraph-rust?
- Fornecer contexto do projeto ao Claude Code ou Cursor antes de refatorar uma base de código grande. Estimar o que pode ser afetado quando uma função, um tipo ou um módulo muda. Entender a arquitetura ou encontrar pontos de alta complexidade em um projeto Rust desconhecido. Executar modelos de embeddings locais e auto-hospedados para manter o código-fonte na própria máquina.
- Como instalar codegraph-rust?
- Siga o Installation Guide (docs/INSTALLATION_GUIDE.md) para instalar o CodeGraph Indexe seu projeto com o nível balanced: codegraph index /path/to/project --index-tier balanced Faça uma pergunta pela linha de comando: codegraph agent context "your question"
- Onde consigo codegraph-rust?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Jakedismo/codegraph-rust
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um grafo de contexto controlado por CLI que indexa seu codebase, issues e conhecimento da equipe para dar aos agentes de programação com IA o contexto específico do projeto.
Framework open source de GraphRAG e agentes que responde a perguntas com múltiplos saltos sobre um grafo de conhecimento, com citações, localmente via Ollama ou na nuvem.
Banco de dados open source de embeddings para apps de IA, que armazena documentos e vetores para buscas semânticas, híbridas e de texto completo.
Um repositório local de memória para IA que registra a quem cada memória pertence, sua origem, quando era válida e quem pode acessá-la.
Transforma uma base de código, sua documentação, schemas e PDFs em um grafo de conhecimento consultável por assistentes de programação com IA, criado localmente com parsing de AST usando tree-sitter.