$git clone https://github.com/tirth8205/code-review-graph<br>
| 1 | <h1 align="center">code-review-graph</h1> |
| 2 | |
| 3 | <a href="https://trendshift.io/repositories/23329?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-23329" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/23329" alt="tirth8205%2Fcode-review-graph | Trendshift" width="250" height="55"/></a> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <strong>Stop burning tokens. Start reviewing smarter.</strong> |
| 7 | </p> |
| 8 | |
| 9 | <p align="center"> |
| 10 | <a href="README.md">English</a> | |
| 11 | <a href="README.zh-CN.md">简体中文</a> | |
| 12 | <a href="README.ja-JP.md">日本語</a> | |
| 13 | <a href="README.ko-KR.md">한국어</a> | |
| 14 | <a href="README.hi-IN.md">हिन्दी</a> |
| 15 | </p> |
| 16 | |
| 17 | <p align="center"> |
| 18 | <a href="https://pypi.org/project/code-review-graph/"><img src="https://img.shields.io/pypi/v/code-review-graph?style=flat-square&color=blue" alt="PyPI"></a> |
| 19 | <a href="https://pepy.tech/project/code-review-graph"><img src="https://img.shields.io/pepy/dt/code-review-graph?style=flat-square" alt="Downloads"></a> |
| 20 | <a href="https://github.com/tirth8205/code-review-graph/stargazers"><img src="https://img.shields.io/github/stars/tirth8205/code-review-graph?style=flat-square" alt="Stars"></a> |
| 21 | <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT Licence"></a> |
| 22 | <a href="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml"><img src="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml/badge.svg" alt="CI"></a> |
| 23 | <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg?style=flat-square" alt="Python 3.10+"></a> |
| 24 | <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square" alt="MCP"></a> |
| 25 | <a href="https://code-review-graph.com"><img src="https://img.shields.io/badge/website-code--review--graph.com-blue?style=flat-square" alt="Website"></a> |
| 26 | <a href="https://discord.gg/3p58KXqGFN"><img src="https://img.shields.io/badge/discord-join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> |
| 27 | </p> |
| 28 | |
| 29 | <p align="center"> |
| 30 | <a href="docs/USAGE.md">Usage</a> · |
| 31 | <a href="docs/COMMANDS.md">Commands</a> · |
| 32 | <a href="docs/FAQ.md">FAQ</a> · |
| 33 | <a href="docs/TROUBLESHOOTING.md">Troubleshooting</a> · |
| 34 | <a href="docs/GITHUB_ACTION.md">GitHub Action</a> · |
| 35 | <a href="docs/REPRODUCING.md">Reproducing the benchmarks</a> · |
| 36 | <a href="docs/ROADMAP.md">Roadmap</a> |
| 37 | </p> |
| 38 | |
| 39 | <br> |
| 40 | |
| 41 | AI coding tools can end up re-reading large parts of your codebase on review tasks. `code-review-graph` fixes that. It builds a structural map of your code with [Tree-sitter](https://tree-sitter.github.io/tree-sitter/), tracks changes incrementally, and gives your AI assistant precise context via [MCP](https://modelcontextprotocol.io/) so it reads only what matters. |
| 42 | |
| 43 | <p align="center"> |
| 44 | <img src="diagrams/diagram1_before_vs_after.png" alt="The Token Problem: 38x to 528x token reduction across 6 real repositories" width="85%" /> |
| 45 | </p> |
| 46 | |
| 47 | --- |
| 48 | |
| 49 | ## Quick Start |
| 50 | |
| 51 | ```bash |
| 52 | pip install code-review-graph # or: pipx install code-review-graph |
| 53 | code-review-graph install # auto-detects and configures all supported platforms |
| 54 | code-review-graph build # parse your codebase |
| 55 | ``` |
| 56 | |
| 57 | One command sets up everything. `install` detects which AI coding tools you have, writes the correct MCP configuration for each one, installs platform-native hooks/skills where supported, and injects graph-aware instructions into your platform rules. It auto-detects whether you installed via `uvx` or `pip`/`pipx` and generates the right config. Restart your editor/tool after installing. |
| 58 | |
| 59 | <p align="center"> |
| 60 | <img src="diagrams/diagram8_supported_platforms.png" alt="One Install, Every Platform: auto-detects Codex, Claude Code, CodeBuddy Code, Cursor, Windsurf, Zed, Continue, OpenCode, Antigravity, Gemini CLI, Qwen, Qoder, Kiro, and GitHub Copilot" width="85%" /> |
| 61 | </p> |
| 62 | |
| 63 | To targe |