Skip to content

GUIDE

Review a pull request

Read the diff, track what you have viewed, comment, submit a review, and merge, all without github.com.

The Changes tab

The Changes tab is a file rail on the left and the diff on the right. Its toolbar holds:

  • Commit scope: shows All changes by default. Pick one commit, or shift-click a range, to review only that span. Alt+↑ and Alt+↓ step between commits.
  • N viewed: how many files you have marked viewed.
  • Search in diff (⌘F): searches the diff text. A selected line becomes the query.
  • Collapse all files, Expand all files, and Reset to viewed-state.
  • Inline diff or Split diff.
  • Review and Ask AI: see AI review and PR chat.

Focus: Code (Shift+M) fills the window with the diff. Esc brings the full review back.

Changes opens at the top of the diff. Show in diff on a thread lands its line just under the file header, with a few lines above it for context.

The file rail

  • List view or Tree view.
  • Filter files (/): type part of a path. path:line jumps to a line.
  • Group by: order the list by dependency, file type, similarity, change size, or with AI. See Group the files in a PR.
  • j and k move between files. v toggles viewed.

Viewed files

Mark a file viewed from its header (Mark file as viewed) or with v. Viewed state syncs with GitHub, so it follows you to github.com and other machines. You can mark a whole folder viewed from the rail. A file stays viewed until its content changes.

File headers

Each file header has Comment on file, Mark file as viewed, Open full-screen, Copy file contents and Expand all lines. Markdown and SVG files switch between Source and Preview. On desktop, Open in editor opens the file at the PR's head commit.

Comments

  • Click a line, or drag across several, to comment. The first comment offers Start a review (held as pending until you submit) or Add single comment (posts right away).
  • Comment on file leaves a comment on the whole file.
  • Type /suggestion in a comment to propose a code change GitHub can apply.
  • n and p move between threads, and r replies to the focused one.

Submit a review

Press ⌘Enter (Ctrl+Enter) or open the review dock to submit. Pick a verdict, Comment, Approve or Request changes, check your Pending comments, then Submit review. Discard review drops the pending comments after asking.

Manage the PR

The status pill in the header (Open, Draft, Merged, Closed) holds Update branch, Mark as ready for review, Convert to draft, Reopen pull request and Close pull request. The merge box on Conversation merges with any method the repository allows (Create a merge commit, Squash and merge, Rebase and merge) or enables auto-merge. Request a reviewer sits in the header. Every action asks before it runs.

Pyor only shows a control you have permission to use. When Pyor cannot write to a repository, it says so once and offers Manage access.

The Conversation tab

Three columns: a timeline that follows your reading, the conversation itself, and an inspector that keeps the merge box and your review in reach. Shift+M opens a focus menu: Active discussion, Awaiting your reply, or Unresolved comments.

A force-push to the PR's branch appears in the conversation as an amber card, "force-pushed" with the time. Compare on it opens "What the force-push replaced". In the timeline it is a one-line amber row that scrolls to the card; hover it to see the event with its Compare link.

On a phone

  • Header (also on a tablet held upright): the title sits at the top of Conversation and scrolls away with it. A fixed bar keeps Back, Focus and the menu, and shows the title once the big one is out of view. The tabs stick under the bar. The status pill and the menu each open a sheet, and a blocked merge names what blocks it.
  • Focus opens a sheet with Off, Active discussion, Awaiting your reply and Unresolved comments.
  • Comment: tap a line, then Comment on line N in the bottom bar. The comment sheet sits above the keyboard and sends from inside the field. Swipe down to dismiss it; your draft stays.
  • AI hints: a selected line with a hint shows a chip in the bottom bar. Tap it to open the hint card, and use Draft a comment to start from it.
  • Files: opens as a sheet. Diff tools sits beside Done in its header.
  • Threads read like a chat, with Reply and Resolve under each one.