riff

    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

    PR list

    • 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.

    Jira tickets

    • 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.

    PR page

    • 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.

    Diffs

    • 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.

    Reviewing

    • 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.

    Stacks

    • 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.

    Prepare review

    • 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.

    Agent

    • 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.

    Terminal window
    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

    Blog