Skip to content

CodeGraph v1.1.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 11:40
· 31 commits to main since this release

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_of depth 20 from 860 ms to 9.7 ms,
    covered_by depth 30 from 1,173 ms to 5.1 ms, find_symbol from 42 ms to 8.8 ms. CODEGRAPH_SNAPSHOT=off
    turns it off; index_status says which path answers.
  • The recursive SQL stays as the reference: parity tests run every read both ways over random graphs, and
    codegraph-bench --parity N does 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-parse on most calls; it falls back to git for anything unusual, such as a reftable repository.
  • codegraph-bench times every query through DuckDB and from the snapshot, and with --server times real
    tool calls through one or more codegraph-mcp builds 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.py mounts whichever of GOBIN and GOPATH/bin holds scip-go. Under mise, GOBIN is Go's own
    bin and every Go run failed with "scip-go is not on PATH".
  • tools/obsidian-e2e/screenshots.py approves the repo's .mcp.json entry, as run_e2e.sh does. Without it
    every panel in the screenshots said spawn codegraph-mcp ENOENT and 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-path

Windows (PowerShell):

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/nerdcules/CodeGraph/main/codegraph/install.ps1))) C:\dev\YourApp -AddToPath

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