The app
Reviewing
Step through a PR file by file, track what you have viewed, comment, and submit a review with a verdict.
Reviewing in riff is a loop: open the files, mark each one viewed, leave comments, and submit. Riff remembers where you are, so you can stop and come back.
Open a PR from the PR list; the Files tab is the diff. For how diffs look and read, see Diffs.
Files, progress and viewed marks
The file list shows how many files you have viewed (for example “4 of 12 viewed”) with a progress bar. A checkmark means viewed. A different mark means you viewed the file before the latest commits changed it.
- Press
vto mark the current file viewed and jump to the next unviewed one. Press it again on a viewed file to unmark it. - A file marked viewed goes back to unviewed when its content changes. Hunks that changed since you viewed them carry a New since you viewed badge.
- Viewed marks are stored in riff, per PR. They survive restarts.
Queues
Queues list the files that need a look. Step through one with ] and [.
| Queue | Files with |
|---|---|
| Changed since review | Changes since you last reviewed or viewed them |
| Open threads | Unresolved review threads |
| Drafts | Your saved comments |
| Unviewed | Nothing viewed yet |
Since my review
Once you have reviewed a PR and the author pushed, a Compare switch appears: All changes or Since my review. The second shows only what changed since your review’s commit, and the files it touches. It is disabled when nothing in the diff changed. In Settings → Diffs you can make it the default.
Comments
Click a line’s comment button (it shows on hover), or drag across line numbers to cover a range.
Press c to comment on the next change. The form has First line and Last line fields to
adjust the range. Suggest change turns on an editor with the original lines, which posts as a
GitHub suggestion.
- Add to review (⌘ Enter) keeps the comment as a draft. It is not visible to others yet. You can edit or delete a draft afterwards.
- Existing threads show who they wait on. Reply… adds to a thread; Resolve and Unresolve change its state. Replies are posted straight away.
- A draft shows a badge when it is in your pending review on GitHub.
Drafts collect on the Review tab, sorted by file and line, each with its code excerpt. That tab holds the AI review card (Prepare), your summary (Write and Preview), the drafts, and your own open threads. A draft from an AI review carries a From AI review badge. Comments from your pending review that riff has no draft of, such as replies, are listed separately, and you can delete them from there.
Drafts and your pending review
With the default setting, drafts are mirrored into your pending review on GitHub as you save them, so you can continue on another machine. See Pull requests.
Submit a review
Click Review in the header (Re-review if you reviewed before and it has new commits, Self-review on your own PR). The dialog has your summary on one side and your comments on the other.
| Verdict | Use it for |
|---|---|
| Comment | General feedback without a verdict |
| Approve | Approve merging these changes |
| Request changes | Feedback that must be addressed before merging |
- The summary is optional for Approve. For the others, add a summary or at least one draft.
- If you started a summary on GitHub’s pending review, riff fills it in and says so.
- Use Write and Preview to check the Markdown.
Cmd/Ctrl+Entersubmits. - Your summary and all your comments post together as one review.
- On your own PR you can only comment.
Keyboard
| Key | Does |
|---|---|
j / k |
Next or previous file |
n / p |
Next or previous change |
] / [ |
Next or previous open thread, or file in the queue you picked |
v |
Mark viewed, go to next unviewed |
c |
Comment on the next change |
e |
Expand all context |
w |
Show or fold whitespace-only edits |
f |
Show or hide the file list |
/ |
Filter files |
? |
Show the shortcuts |
The full list is in Keyboard.
Reviewing from the terminal
riff review reads and writes the same review store, and replies on and resolves threads
on the PR. See riff review.