codegraph-rust

codegraph

Rust rewrite of CodeGraph. Local-first semantic code intelligence + MCP server. Indexes 21 languages with tree-sitter and exposes a knowledge graph to AI agents (Claude Code, Cursor, Codex CLI, opencode) over MCP.

This repository supports two distribution profiles.

---

🚀 Profile A — Quick install for Claude (most users)

One line. No Rust, no Node, no git clone. Just an MCP-enabled binary on PATH.

Windows (PowerShell)

iwr https://github.com/peterctwang/codegraph-rust/raw/main/scripts/install.ps1 | iex

macOS / Linux

curl -fsSL https://github.com/peterctwang/codegraph-rust/raw/main/scripts/install.sh | bash

The bootstrap will:

1. Pick the matching binary for your CPU (5 platform targets supported).
2. Drop it at ~/.codegraph/bin/codegraph and add that to your PATH.
3. Run codegraph install --location global — writes MCP config for every detected agent (Claude Code, Cursor, Codex CLI, opencode), preserving any sibling MCP servers you already have.

After restarting your IDE, Claude / Cursor / Codex all see a codegraph MCP server with 11 tools (codegraph_search, codegraph_callers, codegraph_callees, codegraph_impact, codegraph_context, codegraph_resolve, codegraph_status, codegraph_files, codegraph_languages, codegraph_get_node, codegraph_explore).

Index any project:

cd your-project
codegraph index          # or: codegraph sync --watch

Private-repo install

The repo is currently private. The bootstrap reads GITHUB_TOKEN (or GH_TOKEN) when set — give it a PAT with repo scope:

$env:GITHUB_TOKEN = "ghp_XXXXXXXX"
iwr https://github.com/peterctwang/codegraph-rust/raw/main/scripts/install.ps1 | iex

export GITHUB_TOKEN=ghp_XXXXXXXX
curl -fsSL https://github.com/peterctwang/codegraph-rust/raw/main/scripts/install.sh | bash

Claude Code plugin manifest

The repo also ships a Claude Code plugin manifest at .claude-plugin/plugin.json — useful when listing this server in a plugin marketplace. The manifest expects codegraph to be on PATH, so run the bootstrap once first.

Uninstall

codegraph uninstall --location global   # strip MCP entries from all agents
rm -rf ~/.codegraph                     # remove the binary + PATH entry

---

🛠 Profile B — Development build (contributors)

For working on codegraph itself: 14-crate Cargo workspace, criterion benchmarks, full TDD setup.

git clone https://github.com/peterctwang/codegraph-rust
cd codegraph-rust

cargo test --workspace                                  # 300 tests
cargo clippy --workspace --all-targets -- -D warnings   # zero warnings
cargo fmt --all --check
cargo bench -p codegraph-bench

cargo run -p codegraph-cli -- init
cargo run -p codegraph-cli -- index
cargo run -p codegraph-cli -- serve   # MCP server over stdio

CI matrix runs fmt / clippy / coverage (70% gate) / test on Ubuntu × macOS × Windows / release-build for 5 platform triples. Bench gate fires on PRs touching hot crates.

See ARCHITECTURE.md for the dependency graph + design notes, and PHASE_REPORT.md for the current state of the port vs the original TypeScript reference.

---

Status

300 tests · 21 languages indexable · 13 language extractors with full field enrichment · 13 framework resolvers (Express / Django / Rails / FastAPI / Flask / Laravel / Spring / Gin / Actix / Axum / ASP.NET / SvelteKit / Vapor) · 10 MCP tools · 4-target installer · incremental sync (file-hash) · golden-file diff harness · 5 platform release binaries.

cargo fmt --check and cargo clippy --workspace --all-targets -- -D warnings clean across the entire workspace.

Wire compatibility

The .codegraph/codegraph.db schema and MCP JSON envelopes are byte- compatible with the TypeScript reference; you can swap the npm @colbymchenry/codegraph binary for this Rust one without re-indexing or reconfiguring your agent.

License

MIT