tirth8205/code-review-graph
Code Review Graph
This project is a static code analysis tool and local-first code indexer that builds a persistent dependency graph of functions, classes, and imports. It functions as an AI context optimizer and codebase dependency graph, designed to reduce token usage by providing AI assistants with only the most relevant code fragments and impact analysis for a given change.
The system implements a Model Context Protocol server that exposes code intelligence and architectural graph queries to external AI coding tools. It distinguishes itself by computing the change blast radius and risk scores of modifications, tracing all affected callers and dependent components to isolate the minimum necessary context for review.
The tool includes capabilities for automated architectural documentation generation, structural code visualization in formats such as HTML and SVG, and a syntax-aware parsing pipeline with support for custom languages. It maintains performance in large repositories through bounded structural analysis and incremental hash-based updates that re-parse only modified entities.
Features
- Change Impact Analysis - Traces callers, dependents, and tests affected by a change to isolate the minimum necessary review context.
- Model Context Protocol Integrations - Implements a Model Context Protocol server to deliver compact summaries and impact reports to AI coding assistants.
- Review Context Optimizers - Optimizes AI code reviews by providing only relevant code fragments and impact analysis to reduce token usage.
- AI Context Optimization - Assembles a minimal set of relevant code fragments to optimize the context window and reduce token consumption.
- Codebase Impact Analysis - Computes blast radius and risk scores to determine how modifications propagate through the codebase.
- Context Window Optimizations - Filters codebase data to reduce token consumption by delivering only the most relevant fragments and impact reports to LLMs.
- MCP Protocol Integrations - Exposes graph query capabilities to AI assistants through the Model Context Protocol for structured tool execution.
- Code Analysis Tools - Exposes architectural graph queries and hotspot detection tools to AI assistants via the Model Context Protocol.
- Code Intelligence Tools - Provides a suite of code intelligence tools and prompts integrated through a standardized protocol for AI assistants.
- Codebase Dependency Mapping - Creates a searchable structural map of functions and dependencies to visualize and understand architectural relationships.
- MCP Servers - Provides an MCP server implementation that exposes structural codebase graphs and tool queries to AI assistants.
- Prompt-Optimized Context Retrieval - Selects the minimal set of relevant structural fragments to optimize prompt size and maintain technical accuracy.
- Token Reduction Pipelines - Provides a filtering mechanism to serve only relevant structural data, minimizing tokens required for automated reviews.
- Local Code Indexers - Operates as a background service that monitors repositories and incrementally updates a local persistent graph of code relationships.
- Software Dependency Mapping - Maintains a persistent map of functions, classes, and imports to analyze the blast radius of architectural changes.
- Local-First Architectures - Maintains a persistent, local-first dependency graph of codebase entities for low-latency retrieval.
- Syntax Parsing Engines - Converts source code into structured nodes and edges using a syntax-aware parsing pipeline.
- Structural Graph Generation - Implements a parsing pipeline that converts source code into a structural map of functions, classes, and imports.
- Documentation Generation - Automatically creates markdown wikis and architectural overviews by identifying code communities and patterns.
- Incremental Updates - Uses checksums to incrementally update the structural map, re-parsing only modified entities.
- Bounded Graph Traversals - Limits graph traversal depth to maintain performance and stability when analyzing very large repositories.
- Code Graph Synchronization - Ships a streaming system for importing source files and pull request diffs to keep the local structural map current.
- Large-Scale Codebase Analysis - Implements a bounded structural analysis mode to ensure stability and performance when processing expansive codebases.
- Graph - Provides a background monitoring system that tracks repositories and triggers automatic graph rebuilds upon detecting changes.
- Automated Architecture Analysis - Generates high-level system overviews by detecting structural patterns and code communities in large projects.
- Static Code Analysis Tools - Implements a static analysis pipeline that parses source code into structural maps and automated architectural documentation.
