Repository navigation
CodeGraph v1.1.0
Faster reads
- The MCP server and the web view hold the graph in memory (
GraphSnapshot): node records and adjacency arrays
in both directions, loaded in the background at start and after every re-index. Finds, walks, tests, coverage,
dead code, paths and subgraphs answer from it; the database is opened only for full-text search, vectors and
metadata. Until a snapshot matching the file has loaded, calls read through DuckDB as before.
On Jellyfin (21,174 nodes), through the server at a model's pace:impact_ofdepth 20 from 860 ms to 9.7 ms,
covered_bydepth 30 from 1,173 ms to 5.1 ms,find_symbolfrom 42 ms to 8.8 ms.CODEGRAPH_SNAPSHOT=off
turns it off;index_statussays which path answers. - The recursive SQL stays as the reference: parity tests run every read both ways over random graphs, and
codegraph-bench --parity Ndoes the same over a real graph (0 differences in 6,096 checks on Jellyfin).
SQL orderings now break ties by id, so both answer in one defined order. - The freshness check reads HEAD from
.git(loose refs,packed-refs, linked worktrees) instead of starting
git rev-parseon most calls; it falls back to git for anything unusual, such as a reftable repository. codegraph-benchtimes every query through DuckDB and from the snapshot, and with--servertimes real
tool calls through one or morecodegraph-mcpbuilds over stdio.
Docs
- Every figure re-measured on 14 November 2026 (BENCHMARKS.md, round 12): this repo is now
3,119 nodes and 405 tests, the README's question answers 12 dependents and 37 tests in about 3 ms, and costs
about 5,500 tokens against about 123,000. A save reaches a fresh answer in about a second on this repo, not
"well under a second" as the docs said: the graph doubled since that was measured. - New Obsidian screenshots; redrawn live-daemon and index-time charts; an install diagram that shows the release
download rather than the build from source; a corpus chart that no longer cuts off the Rust line. Jellyfin,
NestJS, RealWorld and the corpus's large profile were measured again for the performance page. tools/corpus/run.pymounts whichever ofGOBINandGOPATH/binholds scip-go. Under mise,GOBINis Go's own
bin and every Go run failed with "scip-go is not on PATH".tools/obsidian-e2e/screenshots.pyapproves the repo's.mcp.jsonentry, asrun_e2e.shdoes. Without it
every panel in the screenshots saidspawn codegraph-mcp ENOENTand the run stopped at Find symbol.- The promo video shows the new figures. Its two sessions were run again headless (
claude -p, Claude Opus 5.5, effort
high, Auto mode) and are replayed from their transcripts: with CodeGraph, 42 s, 4 API calls, 180,134 tokens processed and
exactly 37 tests; without, 87 s, 9 calls, 459,907 tokens and "about 40". The README's GIF is the first of them.
Install
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/nerdcules/CodeGraph/main/codegraph/install.sh | bash -s -- ~/dev/YourApp --add-to-pathWindows (PowerShell):
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/nerdcules/CodeGraph/main/codegraph/install.ps1))) C:\dev\YourApp -AddToPathOr download the archive for your platform below, unpack it anywhere, and run codegraph-index init in a repository.
SHA256SUMS holds the checksum of each file. The executables are not code-signed; on macOS, run
xattr -dr com.apple.quarantine <folder> on a folder unpacked from a browser download.