Features
- Branches and pull requests in one place. Browse local branches, remotes and GitHub PRs, and press
⌘P to jump anywhere.
- Reviews pinned to exact commits. Each review compares from the merge base, so the diff doesn't move when someone pushes.
- Comments that stay local. Nothing goes to GitHub until you publish. Comments land in your pending review, and you submit it.
- Bring your own AI, or none. OpenAI, Anthropic, Gemini, OpenRouter, any OpenAI-compatible endpoint, or a local model in Ollama or LM Studio. Keys are encrypted with your system keychain.
- MCP tools. AI reviewers can call your MCP servers for context the repository doesn't have, like the ticket behind a change.
Install
Download the installer for your system from the latest release. You need Git installed.
On macOS you can also use Homebrew:
brew install hamedghaderi/tap/review
The installers aren't signed yet, so your system asks once on first open. On macOS, go to System Settings → Privacy & Security and click Open Anyway. On Windows, click More info → Run anyway.
Build from source
Requires Node 22.12+ and Git.
git clone https://github.com/hamedghaderi/review.git
cd review
npm install
npm run dev
| Command | What it does |
|---|
npm run dev | Run with hot reload |
npm test | Run the tests (temporary repos, mock servers) |
npm run typecheck | Type-check main and renderer |
npm run format | Format with Prettier |
npm run dist | Build macOS installers (dist:win, dist:linux for the others) |
Docs
- User guide: browsing, pull requests, publishing, AI review, MCP servers
- Architecture: how AI review works, code layout, how reviews are stored
- Releasing: building installers and publishing a release
Support
Review is free and MIT licensed. If it saves you time, you can sponsor it on GitHub, one-time or monthly.
Contributing
Issues and pull requests are welcome. Before opening a PR, run npm test, npm run typecheck and npm run format:check; CI runs the same three. To report a security problem, see SECURITY.md.
License
MIT
