Skip to content

Pull Requests

The Pull Requests tab provides a complete PR workflow — from browsing and filtering to code review and merging.

PR List

The list displays pull requests in a filterable grid with PR-specific columns and quick filters.

Quick Filters

Pre-built filter buttons for common views:

  • All PRs
  • Open PRs
  • My PRs — PRs you authored
  • Needs Review — PRs awaiting your review
  • Ready to Merge — PRs with all checks passing

Filtering

Like the Issues tab, the PR list supports interactive filter chips and a collapsible refine panel with PR-specific filters:

  • Author
  • Reviewer
  • Base branch
  • Review status (approved, changes requested, pending)
  • CI status (passing, failing, pending)

Saved filter presets and dirty-state tracking work the same as in the Issues tab.

ShortcutAction
Arrow Up/Down or K/JNavigate PRs
EnterOpen selected PR
OOpen in new tab

PR Detail

The PR list uses a master-detail layout. In split mode, clicking a PR shows its detail inline within the tab. In list mode, clicking opens a separate PR detail tab in the adjacent pane. Ctrl+Click always opens a separate tab.

The detail view has two modes: Timeline and Files.

Timeline Mode

A chronological view showing:

  • Comments — with inline editing and deletion
  • Commits — each linked to the Commit detail tab
  • Reviews — review comments with approval/rejection status
  • Events — label changes, assignments, status updates

Toggle visibility of each event type with the filter buttons.

Files Mode

A file list showing all changed files with:

  • Viewed status checkbox — track which files you’ve reviewed
  • Inline diff viewer — expand to see changes
  • Side-by-side diff — click the split-diff button
  • Inline comment form — add file-specific review comments

Navigate files with J/K (next/previous file) or N/P (next/previous unviewed file). Press E to toggle a file’s viewed status.

PR Header

  • Title (editable)
  • Description (editable with markdown preview)
  • State and review status badges

Merge Controls

The merge section at the bottom provides:

  • Merge strategy selector — Merge commit, Squash, or Rebase
  • Merge button — merge the PR
  • Auto-merge toggle — automatically merge when all checks pass
  • Update branch — bring the PR up to date with the base branch
  • Delete branch — remove the source branch after merging

Review Panel

Submit reviews with pending comments, dismiss stale reviews, and compare specific commit ranges.

Creating Pull Requests

Click New PR in the PR list to open the creation form:

  • Branch selectors — base and compare branches with a swap button
  • Diff preview — commit statistics between branches
  • Template selector — cards for available PR templates from .github/PULL_REQUEST_TEMPLATE/
  • Title — pre-filled from the branch name
  • Description — with issue linking autocomplete (#N)
  • Reviewers — suggested users as chip buttons
  • Labels — colored pill buttons
  • Draft checkbox — create as a draft PR

If the compare branch hasn’t been pushed yet, the submit button reads Push & Create PR and pushes automatically.

Keyboard Shortcuts

ShortcutActionContext
Alt+IGo to linked issuePR detail
J / KNext/previous fileFiles mode
N / PNext/previous unviewed fileFiles mode
EnterOpen side-by-side diffFiles mode
EToggle file viewed statusFiles mode