Repolode
Jakedismo

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. 1

    Siga o Installation Guide (docs/INSTALLATION_GUIDE.md) para instalar o CodeGraph

  2. 2

    Indexe seu projeto com o nível balanced

    codegraph index /path/to/project --index-tier balanced
  3. 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