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
- Open Review queue in the sidebar, the second section (⌘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:
- Needs your attention: you were mentioned or asked, the author pushed, or the PR is in your area.
- Quick pass: nothing stood out.
- Waiting on author: PRs that wait on the author, such as ones you reviewed where nothing has changed.
- Already approved — FYI: bots, deploys, and PRs others already covered.
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.
- Extra search in Settings → Review queue adds GitHub search qualifiers to every screening, such as
-repo:acme/deploy. SimpleEdit accepts only qualifiers from a known list. On the phone, the Also field in the filter does the same. - The ⋯ menu on a desktop card has Hide this repo, Hide this author and Not interesting. Each one writes a visible qualifier or rule, and an undo toast appears.
- Questions and rules in Settings → Review queue lets you change the questions SimpleEdit asks about each PR and the rules that sort them into buckets. Changes stay in a draft until you select Save. Select Reset to defaults to go back to the shipped set.
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.