Chrome Extension
Guided Review on github.com pull requests. The extension injects Start Guided Review, builds a plan from the real PR diff, and walks it in a Shadow DOM overlay — keyboard-first, with optional line comments and submit. Choosing between hosts: Install. For local git work before a PR exists, use the CLI.
Install
Guided Review runs as a Chrome Manifest V3 extension on github.com pull requests.
Chrome Web Store
- Open the Guided Review listing on the Chrome Web Store.
- Click Add to Chrome and confirm.
- Pin the extension from the puzzle-piece menu so the toolbar icon stays visible — unpinned extensions are easy to forget.
Site shortcuts. On guidedreview.dev, ⌘/Ctrl + E opens the Chrome Web Store listing; ⌘/Ctrl + I jumps to the Install section — see Keyboard shortcuts.
After install
Chrome opens a short welcome page on first install (pin → connect provider → open a PR). You can also:
- Open the extension Options page (right-click the toolbar icon → Options, or open it from
chrome://extensions). - Configure an AI provider and save your API key (optional for a file-by-file walk; required for clustering and summaries).
- Optionally connect GitHub if you want to submit reviews from Guided Review.
- Open a PR and follow Your first review.
Keys and tokens stay on your machine — details in Privacy & data. If the Start Guided Review button never appears, see Troubleshooting.
Options
Open Options from the toolbar icon (right-click → Options) or from the extension card on chrome://extensions. Three cards matter:
| Section | What you set |
|---|---|
| GitHub | Optional device OAuth for submit — Connect GitHub |
| AI Provider | Provider, model, API key — Save, then Test Connection — Configure AI provider |
| Review | Automatically Open on Files Changed — when on, opening a PR’s Files changed / Changes tab starts or resumes Guided Review (off by default) |
Keys go to chrome.storage.local on this browser profile only (not synced). Diff view preference (unified / split) is also stored locally when you toggle it in the overlay — Keyboard shortcuts → Diff view. Storage map: Configure AI provider → Where settings live.
Clearing keys, disconnecting GitHub, or uninstalling: Privacy & data → Clear data.
Start a review
Once you’re on a PR tab:
- Click Start Guided Review on the page.
- Click the toolbar icon — on a PR it starts (or resumes) the review; off a PR it tells you to open one.
- Enable Automatically Open on Files Changed in Options if you want that tab to open Guided Review for you.
Full walkthrough: Your first review.
What else
| Topic | Page |
|---|---|
| Walk units, search, resume | Your first review |
| Overlay layout (sidebar, context, header) | Reading the overlay |
| Images and binary / elided files | Images & binary files |
| API keys and models | Configure AI provider |
| Submit Comment / Approve / Request Changes | Connect GitHub · Submit a review |
| Draft line comments | Leave line comments |
| How the plan is built | How a review plan works |
| Keyboard chords | Keyboard shortcuts |
Next. Your first review · Reading the overlay · CLI · Configure AI provider