All guides

Triaging your Review queue

Your review queue is a list of PRs that someone wants you to look at. The Review queue sorts that list so you know where to start. It reads each PR, puts it in a bucket, and says why. It never posts, approves or decides anything on GitHub.

1. Screen the queue

  1. Open Review queue in the sidebar, the second section (⌘2).
  2. Select ↻ in the section header (its tooltip reads Screen your review queue before the first run). Later runs use the same button, now Refresh.

SimpleEdit sorts the PRs into four buckets:

Each card shows the reasons it landed in its bucket as short chips, for example Mentions you, Pushed since your review, Busy thread, Your area or Bot. Hover a chip to see the evidence behind it. When you have reviewed a PR before and it is on its second round or later, the card says so, for example “round 2”.

Screening does not replace reading. It tells you which PR to open first.

2. Open a PR

Select a card. The Review Room opens the PR with its whole stack. See Reviewing a PR stack.

To open a PR that is not in your queue, paste its link (or owner/repo#123) into Filter, or paste a PR link.

Reviews you started stay in the Continue reviewing group, with their progress. Reopening one resumes at the file you were on. If you already submitted a review and the author has pushed since, opening the PR starts the next round. See Reviewing the next round.

3. Screen on a schedule

Set Auto-screen in Settings → Review queue. It is off by default. You can pick Off or a number of hours. The same pane sets which PRs count, for example how recently they were active.

It screens in the background, even with no window open. SimpleEdit itself must be running.

4. Tune the queue

If the queue shows PRs you don’t care about, change what reaches it.

A tuning action changes the rules, not the cards on screen. The board keeps its buckets until the next screening.

On the phone

The Review tab of the phone companion shows the queue with a filter field and the Also filter. A PR you open there uses the same Review Room, and your threads, drafts and Viewed marks are shared with the desktop.