# Review Box

> A fast desktop app for reviewing GitHub pull requests. Track reviewed files, jump to symbol definitions and uses, search the whole PR and ask AI about changes.

## Features

### Comment and review

Everything you do with comments on GitHub works here: line and multi-line comments, suggestions, replies, reactions, resolving threads and reviews that approve or request changes.

Drafts stay with you. Start a comment in one file, move on through others, and jump back to it any time. Unsent drafts survive switching files and restarting the app.

Finding comments is faster. Every thread in the pull request is in one list, including outdated ones, and you can preview any of them without leaving the file you're reviewing.

The AI can draft comments and replies too, for you to edit and post.

### Pull requests dashboard

The dashboard helps you stay on top of what to review, showing only pull requests from the repos you hand-pick.

Pull requests are split into three sections:

1. **To review** for the ones waiting on you.
2. **Reviewed by you** for the ones you've already looked at.
3. **Yours** for the ones you opened.

Hide any pull request you don't care about, and it stays out of your way.

### File history

See how any file got to where it is, one commit at a time, in one place. Step through the commits. History follows the file through renames.

On GitHub, you open the file, go to its history, then open each commit, and every commit shows all the files it changed. Commits are often whole pull requests, and with AI agents those can touch hundreds of files.

### Track review progress

A clear separation between reviewed and unreviewed files.

Files in a pull request are split into two groups, **Unreviewed** and **Reviewed**, so you can see at a glance what you've reviewed and what's left.

Moving files between the groups is easy:

- Mark or unmark a single file.
- Move a whole folder or a group of files at once.
- Ask the AI to mark files for you.
- Undo with ⌘Z.

### Stacked pull requests

Review Box fully supports stacked pull requests.

While you review one, you see the rest of its stack with each pull request's status, comments and reviews, and can open any of them directly.

On the dashboard, pull requests from the same stack are marked as connected, so you see them as one piece of work.

### Code intelligence

Jump between definitions and usages without leaving the diff.

Review Box understands the code in the diff. For any function, class or variable, you can see where it is defined and every place it is used across the pull request, without checking out the code.

Each file has an outline of its symbols, showing which were added, changed or removed, and which are public or private. You can tell what a file exposes and how a change affects it before reading a single line.

### Checks and reviews at a glance

Each pull request has one badge for its CI checks and reviews. You see where it stands at a glance, on the dashboard and while reviewing.

Open the badge for the details. See who approved, who asked for changes and which checks failed.

### Image diffs

Compare changed images and SVGs visually. Put the old and new version side by side, swipe between them, or overlay one on the other to catch small shifts. Each version shows its file size and dimensions, so a resized image stands out.

### Global search

Press ⌘F to search every changed file in the pull request, both unreviewed and reviewed. Results are instant, even on large pull requests.

The sidebar shows how many matches each file has, so you can see at a glance where a function is used.

### Jump to anything

Press ⌘P to jump to any file in the pull request, or straight to a specific line in it. Type `auth` for the file, `:80` for a line, or `auth:80` for both.

Comments are there too, so you can open any comment thread without scrolling to find it.

### Mention files and people

`@` mentions not only people but **files** from the pull request as well.

This helps when a comment is about more than one file. For example:

_"I see this pattern is used also in `user.rb`, `account.rb`, and `team.rb`. Maybe we can extract it?"_

### Result diff view

See what the code will look like after merging.

With a regular diff, deleted lines sit between the new ones. When a refactoring rewrites half a file, you end up reading two versions at once.

Next to Unified and Split, there is a third way to read a diff: the Result view. It shows the file as it will look after merge, with the added lines highlighted and only a marker where code was deleted.

The deleted code is still there when you need it. Open a marker to see what was removed, and code intelligence and search still find it.

### Integrated AI

Use the AI you already have, from Claude Code and Codex to local models.

- Claude Code
- Codex
- Ollama
- LM Studio
- OpenRouter

Select some lines and ask about them, or ask it to draw a diagram of how the change fits together. It can act for you: mark files as reviewed or unreviewed, and draft comments for you to check before posting.

### Private

There is no Review Box server between you and GitHub. The app connects to GitHub with your own token, and your code and credentials stay on your computer.

AI works the same way. Bring your own agent or local model.

### Dark mode

Dark, light or system mode. I support them all, the choice is yours.

### Markdown preview

Pull requests today carry a lot of Markdown: READMEs, docs, plans and agent instructions. They are easier to review the way they will be read, so Review Box renders them, with added and removed text highlighted.

Combine it with the Result view and you see the final version of the document right away.

### Mermaid diagrams

Mermaid diagrams render everywhere: in Markdown files, descriptions, comments and the AI chat.

Open a diagram full screen to zoom in and move around the details. Copy its source, or download it as PNG or SVG.

### Diff counts everywhere

Added and removed lines show up everywhere you need them.

On the dashboard, see how big each pull request is.

In the Unreviewed and Reviewed groups, see how much is left to review.

On every folder, see how much of the change is tests and how much is code.

### Generated files

Review Box reads your repository's [`.gitattributes`](https://docs.github.com/en/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github). Files marked `linguist-generated` or `linguist-vendored` start collapsed and marked as reviewed, so lockfiles, schema dumps and vendored code don't count toward what's left.

They stay in the list, ready to open when you want to look.

### Review stamps

Every review deserves a proper send-off.

Hit submit. Watch the stamp drop. _THUNK._ LGTM… or _not_.

### …and many small details

I try hard to make a proper [Mac-assed Mac app](https://daringfireball.net/linked/2020/03/20/mac-assed-mac-apps), down to the smallest detail.

For example, when a file name is too long to fit, hover it and the full name appears. When it already fits, nothing pops up.

## Compared with GitHub.com

### Understanding the change

- **Search the diff**: Search across every file, with match counts per file (GitHub.com: Browser search misses collapsed and not loaded files)
- **Result view**: Code as it will be, with deleted lines hidden (GitHub.com: not available)
- **File navigation**: File tree with filter, plus jump to any file, line or comment with ⌘P (GitHub.com: File tree with filter)
- **Code intelligence**: Definitions and uses of any function, right in the diff (GitHub.com: not available)
- **File history**: One file's commits, next to the diff (GitHub.com: Leaves the pull request, and you dig through full commits)
- **Integrated AI**: Your own agent or local model that draws Mermaid diagrams, drafts comments and marks files reviewed (GitHub.com: Copilot only)

### Reviewing the change

- **What to review**: Review dashboard with what to review and what you already reviewed (GitHub.com: Search filters)
- **Review progress**: Unreviewed and reviewed files, so you see what is left (GitHub.com: Viewed checkbox on each file)
- **Bulk review**: A whole folder at once, with undo (GitHub.com: One checkbox per file)
- **Comments and reviews**: Description, reviews and threads grouped together, with quick previews (GitHub.com: Split across the Conversation and Files tabs and panels)
- **Generated files**: Marked reviewed automatically from .gitattributes (GitHub.com: Collapsed only)

## Pricing

$45 per year.

- 30 days trial, no account and card required
- All features
- Updates for a year
- Stop paying and you keep the version you have

## FAQ

### Does my code go through your servers?

No. Review Box talks to GitHub directly from your computer, using your token. If you have the GitHub CLI installed, it uses its token and never stores it. Otherwise, it uses a personal access token, stored encrypted. Your credentials never leave your computer.

### What GitHub access does it need?

If you use the GitHub CLI, nothing more. Review Box picks up your `gh` login. Otherwise, a classic personal access token with `repo`, `read:org` and `notifications`.

### What happens if I cancel my subscription?

The app keeps working. You won't get new versions until you renew.

### Do I need AI?

No. Everything else works without it. Bring your own provider if you want it.

### GitLab, Bitbucket, GitHub Enterprise Server?

Only GitHub.com for now. The others are planned for the future.

## Recent releases

### 26.11.2 (2026-11-13)

- **Feature**: See when an open pull request gets updates.
- **Fix**: Find the uses of a constant or variable defined at the top of a file in the rest of its diff.

### 26.11.1 (2026-11-09)

- **Feature**: Merge button for pull requests.
- **Feature**: Screen readers announce the keyboard shortcut of buttons that have one.
- **UI**: Sort pull requests dashboard by newest first, so we have consistent lists.
- **Fix**: Swift and C# files syntax highlighting.

### 26.10.9 (2026-10-30)

- **Feature**: The file header icon shows when a file has a test or is a test; click it to jump between them.
- **Fix**: Opening another file starts its diff at the top, instead of where the previous file was scrolled to.
- **UI**: Improved feedback with screenshot UX.
- **UI**: Simplify the watched repositories modal.

### 26.10.8 (2026-10-28)

- **Feature**: Use the GitHub CLI token (`gh auth token`), when available.
- **Feature**: Filter pull requests to review by assignee.
- **Feature**: Hover a comment in the comments lists to preview its whole thread or draft beside the list.
- **Feature**: AI chat can search across all changes in the pull request.
- **Fix**: Comment drafts are no longer lost when new commits are pushed to the pull request.
- **UI**: Mermaid diagrams in AI chat messages are bigger and more readable.
- **UI**: Improve display of pull requests dashboard.
- **Fix**: Right-clicking a file in the sidebar no longer selects it or opens it in the diff.

### 26.10.7 (2026-10-20)

- **Feature**: Code navigation in the diff. See where a symbol is defined and used across the pull request.
- **Feature**: Reviewed files list section can be collapsed.
- **Fix**: Make the "Restart to install" update banner readable in the dark theme.

## Links

- [Download Review Box](https://review-box.rstankov.com/download): Download Review Box for macOS, Linux or Windows.
- [Privacy](https://review-box.rstankov.com/privacy): What Review Box sends, where, and what it keeps.
- [Release notes](https://review-box.rstankov.com/release-notes): What changed in each version of Review Box.
- [Terms of Sale](https://review-box.rstankov.com/terms): Terms of sale for Review Box.
