🔗 code-review-graph - Improve your code reviews with maps

Code-review-graph builds a map of your software code. It helps AI tools read your files. This tool makes AI work faster and smarter when it scans your projects. Use it to speed up your deep dives into large codebases.

📥 Getting Started

Follow these steps to set up the software on your Windows computer.

1. Visit the releases page to see all versions.
2. Look for the file ending in .msi or .exe under the latest release heading.
3. Click the file name to download the installer to your Downloads folder.
4. Open the file you just downloaded.
5. Follow the prompts on the screen to install the software.
6. Launch the program from your Start menu once the installation finishes.

🛠️ Requirements

Your computer needs these items to run the software:

• Windows 10 or Windows 11.
• A stable internet connection for the first setup.
• 4GB of RAM.
• 500MB of free hard drive space.

🎯 How it Works

The tool uses a process called static analysis. It scans your files to learn how parts of your code connect. It saves these connections in a graph. A graph acts like a map for your files. When you ask an AI to fix a bug or explain a function, the AI uses this map. It ignores useless code and focuses on specific parts. This saves time and money. It also keeps your data local. Your code never leaves your computer.

⚡ Key Features

• Automated Mapping: Start the tool, click scan, and watch it map your folders.
• Context Reduction: The tool feeds small, relevant chunks of code to AI agents.
• Large Project Support: Work on big codebases without slow performance.
• Simple Interface: Click buttons to control the scanner.
• Privacy First: Your source code stays on your local machine.

⚙️ Using the App

Open the application after installation. You will see a text box for your project folder path. Type or paste the location of your code here. Click the "Build Graph" button. The tool creates a file called code-map.json in your project folder. This file contains the links between your code blocks. Use this file with your favorite AI coding tool. The tool links to your code, identifies the core logic, and presents it for review.

❓ Frequently Asked Questions

Does it change my code? No. The tool only reads your files. It does not delete, edit, or move your work.

Can it scan multiple languages? Yes. The tool understands many common coding languages through tree-sitter technology.

What if the scan fails? Check that you have permission to read the folder you chose. Ensure no other programs are currently editing those files. Try running the app again.

Does it need the cloud? The app runs on your computer. It does not transmit your source code to external servers.

🛡️ Support

Contact us through GitHub issues if you find bugs. Describe the steps you took before the error happened. Attach a screenshot if possible. Provide your Windows version so we can troubleshoot effectively.

Keywords: ai-coding, claude, claude-code, code-review, graphrag, incremental, knowledge-graph, llm, mcp, python, static-analysis, tree-sitter