riff
A code-diffing and pull request review tool for GitHub. It reads your git repository directly and shows diffs,
your PRs, their checks and threads, and your draft comments.
Binaries riff and riff-web run the same UI. All three share the config file, the saved PR data
and the review store.
riff The app. Opens the repository in the current directory, a path, or a PR URL. riff --web serves the same UI to a browser. riff-web The browser version on its own, served on localhost:7433. Released for macOS and Linux. riff-diff Command line. Prints diffs, and reads and acts on PRs and reviews as text or JSON. Features Sections from “Continue reviewing” and “Requested from you” to “Ready to merge” and “Fix”. Each row gives its reason (for example “Failing: build +1”) and who it waits on. One row action: Resume, Merge, Resolve, Check, Re-request or Nudge. Snooze a PR until its head commit or review decision changes. Each row shows its ticket key, status and assignee, found in the branch name or title. The PR page has a Jira card: summary, type, epic, acceptance criteria, description and testing. The ticket’s links (blocked by, blocks, relates to) with each linked ticket’s PR and stage. Group the list by Jira epic, in merge order, or by team. Summary, Files and Review tabs; open PRs stay as tabs in the sidebar. A merge verdict over four gates: reviews, checks, threads and branch, plus Depends, Order and Unblocks from Jira. Failing checks with Re-run; merge by squash, merge or rebase as the repository allows. Merging ahead of an unshipped Jira blocker asks first. Working tree: uncommitted, staged, unstaged, or the current branch against another. Syntax and word-level highlighting, with the enclosing function in each hunk header. Large diffs load file by file, so the first file shows before the rest are read. Fold imports and comments, wrap lines, ignore whitespace, or fold re-indented lines. Mark files viewed; a file that changes after you viewed it goes back in your queue. Queues for changed since review, open threads, drafts and unviewed files. “Since my review” shows only what changed after your last review. Comments are drafts in your pending GitHub review until you submit once, with a verdict. A stack of PRs is one row in the list, and a bar on each PR page. Step between layers with [ and ] on the PR page. Optional; needs a model and key in the config file. A reviewer with read-only tools goes over the change, then its findings are re-rated. Findings land as draft comments and a summary you can edit. Nothing is submitted. The card streams concerns and findings live; you can stop the run. A chat panel (⌘J) that knows the PR, file and lines you are on, and reads the Jira ticket. It can write, reword and delete your drafts and summary; every change can be undone. It cannot submit a review. Command line
Every riff pr verb takes --json (versioned schema) and has documented exit codes. See
the command-line reference .
riff-diff main...feature # merge-base diff of a branch
riff-diff --staged --split # staged changes, side by side
riff pr inbox # PRs that need you, with the reason
riff pr status owner/repo#42 # checks, reviews and threads of one PR
riff pr merge 42 --yes # also rerequest, rerun, reply, resolve, snooze
riff review status # the branch's review and its PR threads
riff prepare owner/repo#42 # draft a review into your pending GitHub review