A better way for humans to review AI generated code
Guided Review is a Chrome extension that makes “reading code” wayyyy better with clustered file changes, summaries, and a keyboard-first experience.
Free · Open source · Bring your own LLM key
Why?
Code review is hard,
and it's only getting harder
AI agents are writing code for you, and you have PRs pending your review. When you installed the new hot code review agent on GitHub, you imagined it would make the job easy. You'd click "approve" and move on to the next PR.
Unfortunately, agents writing code and agents reviewing code are not a replacement for you (congrats, your job is safe). You have more context. You know people, business, and the product better than your coding agent.
End of the day, you are still going to have to read the code. You are still going to have to understand it, and then you have the final say.
But... it's just too much code, and it's hard to review code.
What if we used AI to help us review code, and not review it for us?
That's why I built Guided Review. It's an experience designed for humans, that uses AI in just the right places (not too little, not too much).
Reading the code matters more than ever now that you didn't write it.
Features
Built for humans who still have to read the code.
- clustered-changes.diff
Review changes, not files
GitHub gives you every changed file in alphabetical order and leaves you to work out how they connect. We use AI to cluster related changes into review units, so you read the change, not the file list.
- navigation.keys
Read and navigate how you write
We've designed the whole code review experience to be keyboard first.
You will not need to lift your hands from your keyboard to browse, comment, or review.
- summaries.ai
Summaries (because AI)
Get a 2 line overview of every change. Sometimes it's really helpful, sometimes it's not. Take it with a grain of salt.
Model companies apparently block your API keys if you do not implement summarization. Seriously.
- approved-tools.json
Tools corporate security has already approved
Bring the AI provider your company already approved — Claude, OpenAI, or Grok — and your own API key. Want to read the code that handles that key? It's open source (without VC funding), so you can read it, or fork it and point it somewhere else, or modify it for your own workflow.
Please check with your employer if they've policies about this. If you're a 2 person startup, you're (probably) fine.
Your code never touches our infrastructure
The extension talks directly to your AI provider and GitHub. We never see your diffs, your keys, or your code — because there's nothing on our end to see them with.
FAQs
The questions everyone asks before installing.
So how does it actually work?
Once the Chrome extension is installed, it adds a Start Guided Review button to the GitHub PR page. Click it and the review opens as an overlay on top of GitHub.
We read the diff from the PR, send it to your configured AI provider to get review units and summaries, map those back to the diff, and show you the result.
Which AI providers work?
Claude (Anthropic), OpenAI, and Grok (xAI). You pick the provider and model in the extension's options pageand paste your own API key. We'll keep adding more providers — request one on the GitHub repo, or open a PR that adds yours.
Will this run up my API bill?
Starting a review makes one call to your provider to cluster the diff into review units and summarize them. Cost scales with how big the diff is and which model you picked — a small PR on a cheap model is fractions of a cent, a huge PR on a frontier model is not.
You're paying your provider directly, so whatever it costs shows up on their dashboard, not ours. We never see it.
So you don't track anything at all?
Yes. There's an anonymous analytics script on this website, and that's it. The extension doesn't track anything and doesn't talk to any third-party servers other than GitHub and your AI provider.
Is it free forever?
Forever is a long time. It is free until it can be maintained for free. If demand for the tool increases and it takes a lot of my bandwidth to maintain, I will introduce some way to be compensated for the extra time. But since it's open source, you can fork it if you find I'm not a good person.
Get Guided Review
Install the Chrome extension, add an LLM API key in options, and open any GitHub pull request. Click Start Guided Review to begin.