riff

    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.

    Terminal window
    riff # open the repository in the current directory
    riff ~/code/project # open another one

    What it does

    • Diffs, fast. Your working tree, branches and PRs, with syntax highlighting and intra-line word diffs; riff-diff adds 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 pr and riff review print what the app shows, as text or JSON, with stable exit codes for scripts and the Raycast extension.

    Where to go next