Start
Introduction
What riff is, what it's for, and the three ways to run it.
riff is a fast code-diffing and pull request review tool. It reads your git repository directly, renders diffs with syntax and word-level highlighting, and puts everything a review needs in one place: the PRs waiting on you, their checks and threads, the change itself and your draft comments.
Three ways to run it
| Entry point | What it is |
|---|---|
riff |
The desktop app (macOS). The primary way to use riff. |
riff-web |
The same UI in a browser, served on localhost:7433. |
riff-diff |
A non-interactive command line that prints diffs and drives PRs and reviews. |
The desktop app and the browser run the same interface. The desktop app starts the server in-process and opens a window on it, so anything you can do in one you can do in the other.
riff # open the repository in the current directoryriff ~/code/project # open another oneWhat it does
- Diffs, fast. Your working tree, branches and PRs, with syntax highlighting and intra-line word diffs;
riff-diffadds commits, ranges, split view and diff algorithms in the terminal. Large repositories load file by file, so the first file shows before the last one is read. - Your open PRs as tabs. Each keeps its file, scroll position and drafts while you switch.
- A PR inbox that ranks by what you need to do. Review requested, changes requested, failing checks, unresolved threads: each PR says why it’s in your list and what the next move is.
- Reviews you can resume. Viewed marks reset when a file changes, queues gather open threads and drafts, and Since my review shows only what changed after your last pass.
- Assist, if you want it. With a model configured, riff can prepare a review as draft comments and a summary for you to edit, and a chat sidebar answers questions about the change and can work on your drafts. Nothing is ever submitted for you.
- Scriptable.
riff prandriff reviewprint what the app shows, as text or JSON, with stable exit codes for scripts and the Raycast extension.
Where to go next
- Install riff
- Your first review, a short tour
- The command line