Introduction
What Reviewer is, and where to start reading.
Coding agents write most of the code now, but someone still has to read it. Reviewer is where you do that. You read the change, leave a comment on every line that is wrong, hand the comments back to the agent, and commit once the result is right.
Reviewer comes in two forms:
- The Mac app, a native window for Apple silicon Macs.
- The terminal app, which runs in a terminal on macOS and Linux.
Both are free and open source, and both talk to the same small server on your machine. A comment you leave in one shows up in the other, and so do your workspaces and run commands.
Where to start
Installation
Install the Mac app or the terminal app.
Concepts
Repositories, comparisons, comments and the server underneath.
Mac app
Review in a native window, with agents beside the diff.
Terminal app
Review over SSH or in the terminal you already live in.
A review, start to finish
A typical review looks like this:
- An agent changes your code, in Reviewer or anywhere else.
- You open the repository in Reviewer. It shows the uncommitted work, or your branch compared with the branch it will merge into.
- You read the diff and comment on the lines you want changed.
- You hand the comments to an agent: from the Mac app directly, or through the skill for any agent you run yourself.
- The agent's fix shows up as a new diff. You read it, and commit when you are satisfied.
Nothing is committed for you. Reviewer only commits when you ask it to.