mrkeyoor.com_
Mon 02 Nov 15:20 UTC
AI Toolsevaluationupdated 25 Oct 2026

code-review-graph review

code-review-graph builds a local SQLite graph of code symbols and relationships, then exposes it through a CLI and MCP tools for questions about callers, change impact and related tests. Its README describes incremental indexing with Tree-sitter. Our recorded run checked dependency setup, a build step and a timed test command; it did not verify graph accuracy or context savings.

+133stars / 7d
Verdict

code-review-graph is worth a repository-specific trial when reviewers need to follow relationships across files. Its documented features fit that task, but our 2026-09-29 run at commit 6b12d11 establishes only successful install and build steps, a recorded dependency footprint and an unfinished test command. It does not verify a working CLI, graph quality or token savings. Before adopting it, verify the executable, index a representative repository and compare its affected paths with source and tests.

We ran it

Lab card: what happened when we ran code-review-graphScreenshot of code-review-graph (code-review-graph.com)
Install✓ · 104s173 packages · 6077 MB
Build✓ · 9s
Tests✗ timed out · 900sran, no count parsed
Known vulns2(pip-audit)
Repo470 files~162,434 lines of source · 12.9 MB · 8 CI workflows · tests dir

Answers from our run

Does code-review-graph build from source?

Dependencies installed in 104 seconds (173 packages), and the build succeeded in 9 seconds. We cloned commit 6b12d11 into a clean Debian container with 3 CPUs and no project-specific setup.

Do code-review-graph's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Does code-review-graph have known vulnerabilities in its dependencies?

pip-audit flagged 2 known advisories in the dependency tree at the time of our run.

Who should not use code-review-graph?

Readers seeking independently measured token savings or impact accuracy: our run measured neither.

What are the alternatives to code-review-graph?

codebase-memory-mcp, CodeGraphContext. code-review-graph is worth a repository-specific trial when reviewers need to follow relationships across files.

Setup2/5The dated install and build steps succeeded, but no installed-CLI or graph-generation check was recorded. The 6,077 MB dependency footprint describes this environment, not a minimum installation.
Docs4/5The supplied README and v2.3.9 notes provide setup instructions, benchmark limits, tool filtering and specific migration and recovery steps. We did not independently verify every documented workflow.
Community3/5The supplied issue listing shows reports from multiple contributors through 2026-10-19. It does not establish adoption, maintainer response times or resolution rates; star counts are not used.
Maturity2/5v2.3.9 documents migration and client-compatibility requirements, but our evidence lacks a completed suite and operational graph checks. The timeout and 2 recorded advisories do not establish product failure or exploitability.

Discussed on

  1. hnCode-review-graph: persistent code graph that cuts Claude Code token usage12 points

Who it’s for

Reviewers evaluating structural context for changes that cross several files.
Teams using MCP-compatible coding agents and willing to check graph results against source code.
Engineers prepared to maintain a local index and coordinate graph migrations with client integrations.
GitHub users evaluating the documented Action for risk notes and affected-flow hints on pull requests.

Who it’s NOT for

Readers seeking independently measured token savings or impact accuracy: our run measured neither.
Developers handling trivial single-file edits, where the README says graph context can exceed a plain file read.
Teams requiring a completed test result before adoption: our recorded command timed out, leaving the suite result unresolved.
Users expecting language-server precision for every relationship. The README says LSPs remain more precise per symbol and identifies JavaScript and Go flow-detection limits.
Operators unwilling to let the integration installer modify agent configuration, hooks, skills and rules files.

Setup reality

In our recorded run on 2026-09-29 at commit 6b12d11625cbec3b6773e076cb3d136464fa90e5, the install step exited successfully in 104 seconds and the build step exited successfully in 9 seconds. The record lists 173 dependencies and 6,077 MB of installed dependency footprint. The install tail identifies a Python 3.12.12 environment, but does not establish that the code-review-graph CLI was installed or runnable. The build tail is empty, so the build result does not establish that a repository graph was generated.

The test command timed out after 900 seconds with exit 124. Its tail contains skip markers, passing dots and progress labels through 4%; no complete test count or final suite result was recorded. Pip-audit reported 2 advisories affecting 1 package. Package identity, severity and audit coverage are unknown from this record; 173 dependencies is not a count of audited packages.

The sandbox configuration recorded 3 CPUs, 8 GB of memory and image ghcr.io/astral-sh/uv:python3.12-bookworm. The checkout measured 470 files, 162,434 lines and 12.9 MB, with 8 CI workflow files, a tests directory and no Dockerfile. These are checkout and environment observations, not indexing or review-workload measurements.

The README requires Python 3.10+ and documents a separate integration installer. Optional cloud embeddings send source-derived text to the configured provider. The v2.3.9 release notes describe automatic schema migration from 9 to 13, a full-table rewrite and FTS rebuild, and separate steps for parser fixes, generated hooks and the VS Code extension.

Structural context needs a separate acceptance check

code-review-graph is designed to help a coding agent follow callers, imports and related tests across files. The adoption question is whether that graph gives your reviewers useful context at an acceptable setup and maintenance cost. Our recorded run supplies some setup evidence, but no answer about graph accuracy or review savings.

The README describes a Tree-sitter parser, local SQLite storage, incremental updates, 30 MCP tools, 5 workflow prompts, a CLI, watch mode and a GitHub Action. Those are documented capabilities. We did not exercise those workflows in a measured review task.

What our recorded run establishes

Our run took place on 2026-09-29 at commit 6b12d11625cbec3b6773e076cb3d136464fa90e5, associated with v2.3.9. The install step exited 0 in 104 seconds; the build step exited 0 in 9 seconds. The record lists 173 dependencies and 6,077 MB of installed dependency footprint, alongside a 12.9 MB checkout containing 470 files and 162,434 lines.

These figures describe the recorded environment. They do not establish the minimum production installation size, graph database size or memory used during indexing. The install tail says it used Python 3.12.12 at /work/home/venv. It contains no installed-binary check. The empty build tail provides no evidence that the build step indexed the checkout, so its 9 seconds must not be presented as graph-build latency.

The configured sandbox had 3 CPUs, 8 GB of memory and image ghcr.io/astral-sh/uv:python3.12-bookworm. The checkout had 8 CI workflow files and a tests directory, with no Dockerfile detected. The record does not establish the earlier draft's claims about privilege level or absence of secrets.

The suite result remains unresolved

The test command hit its 900-second limit and exited 124. The retained output shows skipped-test markers, passing dots and progress labels through 4%. That last visible percentage is not a verified completion percentage at termination. No complete test total or final result was recorded, and we cannot derive unique passing or skipped counts from this tail.

A timeout does not establish that the product is broken or that individual tests failed. It means this command did not provide a completed suite result within our recorded budget. Teams that require a green acceptance gate still need that evidence.

Pip-audit recorded 2 advisories affecting 1 package. The record does not identify the package, advisory severity or number of packages inspected. Audit coverage is unknown, and the dependency count cannot fill that gap. This is a dated audit observation, not a finding about exploitability or current exposure.

Context savings are an upstream benchmark claim

The README reports about 63x median per-question token reduction across 6 repositories, comparing whole-source-corpus input with graph-query output. It dates that capture to 2026-08-02, using crg 2.3.7 and pinned repository snapshots. Those are upstream benchmark results, not measurements from our v2.3.9 run.

The baseline matters: the README calls whole-corpus input an upper bound and says no canonical capture has been published for its grep-and-read agent baseline. It also says graph context can exceed a plain file read on trivial changes. The published ratio therefore does not establish savings for your agent's existing workflow.

Impact accuracy has a similar limit. The README explains that its recall of 1.0 uses ground truth derived from the same graph the predictor traverses. Its independent co-change mode returned no predicted files on every graded commit in the 2026-08-02 capture and was not yet a usable measurement. Treat affected paths as candidates to inspect, rather than proof that all affected code or tests have been found.

Installation and upgrades involve more than the package

The README requires Python 3.10+. Its integration installer detects supported clients, writes MCP entries and adds hooks, skills and graph instructions where supported. That is a separate operation from dependency setup. The README also documents tool filtering through --tools or CRG_TOOLS, which lets an operator expose a selected set of MCP tools.

The documented default graph is local SQLite storage. Optional cloud embeddings send identifiers, signatures, structural context and bounded documentation summaries to the selected provider; the README says function bodies are not sent. Choose that option with the data transfer and provider charges in mind.

The v2.3.9 release notes, dated 2026-09-18, move graph schema 9 to 13. They describe a full-table rewrite and FTS5 rebuild on first open, warn that the migration is not resumable, and advise backing up a database that matters or deleting it and rebuilding. Parser fixes require a full graph rebuild because unchanged files otherwise skip parsing. Generated hook changes require rerunning the integration installer.

The same release notes say the VS Code extension is versioned separately. They describe vscode-v0.2.1 accepting schema 6, the repository's untagged 0.2.2 accepting schema 9, and repository version 0.3.0 accepting schema 13. This is a release-time compatibility warning, not verification of which extension build is available or installed today. Our successful build step does not measure migration, re-indexing or client-upgrade time.

Choose a trial that can answer the missing question

Start by verifying that the CLI runs, then index a representative repository and inspect any partial-parse warnings. Select a change with known callers and tests. Compare the reported affected paths with the source, record missed and extra paths, and compare context consumption with your agent's normal search-and-read workflow. These are proposed acceptance checks, not work completed in our run.

The supplied issue listing includes reports dated through 2026-10-19 about watcher lifecycle, indexing and integration behavior. Reports establish topics raised by contributors; they do not independently confirm each defect or its current resolution. They are useful prompts for choosing local checks.

For deployment alternatives, codebase-memory-mcp documents a native runtime requiring no Docker or language runtime. CodeGraphContext documents embedded and external database backends plus optional SCIP indexers. Neither extract supplies a controlled comparison with code-review-graph. Choose which to evaluate by those requirements, then measure the behavior that matters to your repository.

How to read the scores

Scores are editorial evidence assessments, not benchmark results. The rubric is: 1 means little usable support for the dimension, 2 means substantial unresolved evidence gaps, 3 means documented support with limited independent verification, 4 means detailed support with explicit limits, and 5 requires broad independent verification. Setup considers verified operational readiness; docs considers actionable instructions and caveats; community considers demonstrated participation rather than popularity; maturity considers compatibility and operational evidence. Unknown adoption, responsiveness and reliability cannot earn a high score.

Alternatives

ProjectWhat it isPick it when
codebase-memory-mcp gh↗A local code knowledge graph and MCP server distributed as a native runtime.Consider it when avoiding a language runtime or Docker is a deployment requirement. Its README says the native runtime needs neither; we have not compared installation size, accuracy or speed.
CodeGraphContextA code graph CLI and MCP server with embedded and external database options and optional SCIP indexing.Consider it when database choice or optional SCIP indexers are requirements. Its documentation describes both, but our evidence does not establish better symbol resolution or lower operating cost.

What people are saying

  1. [github-trending] tirth8205/code-review-graph

Sources

  1. code-review-graph README
  2. code-review-graph v2.3.9 release
  3. Sandboxed commit 6b12d11
  4. code-review-graph open issues

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →