Install
Guided Review is one review engine with two hosts. Install the surface that matches the change you’re reviewing — or both; they share providers, units, and keyboard habits.
| Host | Use it when… |
|---|---|
| CLI | You’re on a local branch, commit, or working tree |
| Chrome extension | The change is already a PR on github.com |
Same clustering pipeline either way. The extension can submit to GitHub; the CLI keeps notes local and offers Generate Prompt. Motivation: Why. Product map: Introduction.
Pick a host
CLI — Node.js 22+, then:
npx @guided-review/cli
The published package is @guided-review/cli. The binary is guidedreview. npx guided-review (unscoped, hyphen) is a different tool. The CLI binds localhost, opens the browser UI, and walks file-by-file until you hit Structure With AI.
Chrome extension — Install from the Chrome Web Store. On a PR, click Start Guided Review (or the toolbar icon). Pin the extension so the icon stays visible.
A provider key is optional for a file-by-file walk; required for AI clustering and summaries — Configure AI provider.
Detailed docs
Full install steps, Options, flags, and day-two workflows live on the app pages:
- Chrome ExtensionPull requests on github.com
Install from the Web Store, then Start Guided Review on any PR — comments and submit included.
Extension docs → - CLILocal branch, commit, or working tree
Run Guided Review from your terminal before a PR exists — same walkthrough in a localhost browser UI.
CLI docs →
After you install
- Configure an AI provider (extension Options or CLI Settings / env).
- Extension path: Your first review. CLI path: CLI → Follow the Walkthrough.
- Optionally connect GitHub if you’ll submit from the extension.
Stuck on a missing button, provider error, or port conflict: Troubleshooting.
Next. Chrome Extension · CLI · Configure AI provider · Your first review