Skip to content
Revue

Open pull requests, branches and folders

Each tab in Revue reads one thing: a pull request, a branch, your working copy or a comparison. This page covers every way to open one. A new tab (⌘T) opens on the Inbox.

From the Inbox

Section titled “From the Inbox”

The Inbox lists the pull requests waiting for you. Select one and press ↩, or choose Open review in the preview pane. Each pull request opens in a tab of its own, on its Overview. If it already has a tab, Revue goes to that tab.

You can also find any pull request from the command palette. Press ⌘K (or ⇧⌘P) and type part of its title or number. The palette searches your tabs, commands, the files in this comparison, branches and pull requests, worktrees and GitHub. When nothing matches, it offers to search GitHub for what you typed. Type > first to list only commands.

From a folder or Open Recent

Section titled “From a folder or Open Recent”

To review a checkout on your Mac, choose File › Open Repository (⌘O) and pick its folder. Revue opens the branch that’s checked out, with its stack and snapshots. File › Open Recent lists the last folders you opened. An empty pane offers the same choices.

A tab named ember while Revue is opening the checkoutA tab named ember while Revue is opening the checkout

A branch and its pull request open in separate tabs. The branch tab shows what’s on your Mac. The pull request tab shows what GitHub has, and is where you review it. The one exception is a layer of a gh-stack stack checked out on this Mac: its pull request opens as that layer, so you don’t get a second tab.

From the terminal

Section titled “From the terminal”

With the command line tool installed:

Terminal window
revue                              # open this checkout
revue ~/src/ember                  # open another checkout
revue --pr owner/repo#123          # open a pull request from anywhere
revue --pr owner/repo#123 --path src/retry.rs --line 42

Revue opens it in the running app. Add --new-tab to always make a new tab, or --new-window for a new window. --pr can also go straight to a thread, a comment, a review or a line. Command line lists every option.

Section titled “From a Revue link”

A Revue link names a pull request, and can point at a thread, a comment, a review or a line in it. It looks like revue://pr/owner/repo/123?thread=…. Anyone with Revue who opens it goes straight there.

  • Copy one: select a thread and choose Edit › Copy Revue Link to Thread. For someone without Revue, choose Edit › Copy GitHub Link to Thread instead.
  • Open one: click it in any app, or pass it to the command line: revue 'revue://pr/owner/repo/123?thread=…'.

Links to GitHub pull requests in a description or comment open in Revue as a tab too. Other links open in your browser.

Branch tabs follow your checkout

Section titled “Branch tabs follow your checkout”

A branch tab follows your checkout. When you switch branch in Terminal or another app:

  • If the tab is in front, a notice says “Checkout switched to” the new branch, with Show it and Stay here. Stay here keeps the tab where it is.
  • If the tab isn’t in front, it moves, and says “Switched to” the new branch the next time you look at it.

A tab you pointed somewhere yourself, by choosing a layer or a snapshot, stays where it is. Its context bar offers the checked-out layer instead. A comment you’re still writing also keeps the tab where it is. Running revue in the checkout moves its tab to the branch and lets it follow again. Revue never switches your branch.

Section titled “Related”