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.
Navigation
| Shortcut | Action |
|---|---|
| Arrow Up/Down or K/J | Navigate PRs |
| Enter | Open selected PR |
| O | Open 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
| Shortcut | Action | Context |
|---|---|---|
| Alt+I | Go to linked issue | PR detail |
| J / K | Next/previous file | Files mode |
| N / P | Next/previous unviewed file | Files mode |
| Enter | Open side-by-side diff | Files mode |
| E | Toggle file viewed status | Files mode |