PRDeck

A keyboard-first PR inbox for GitHub on macOS — powered by the GitHub CLI (gh).

PRDeck shows:

• Pull requests you authored (author:@me)
• Pull requests requesting your review (review-requested:@me)

It’s built for fast triage: copy links with a click, open with a double-click, and navigate with the keyboard.

Screenshot

Requirements

• macOS 14+
• Homebrew (recommended install + easiest way to install gh)
• GitHub CLI installed: gh (e.g. brew install gh)
• Logged in: gh auth login (for private repos, use gh auth login -s repo)

Install

Option 1: Homebrew (recommended)

1. Install gh (if needed) and log in (interactive):

   brew install gh
   gh auth login

2. Tap + install:

   brew tap marcomariscal/prdeck
   brew install --cask prdeck

Upgrades:

brew upgrade --cask prdeck

Option 2: Download a release

Download the PRDeck-v<version>-macos.zip asset from the Releases page, unzip it, and move PRDeck.app to /Applications.

PRDeck releases are meant to be signed + notarized (see RELEASING.md). If macOS blocks the first launch, try right-click → Open.

Option 3: Build from source

1. Clone the repo:

   git clone https://github.com/marcomariscal/prdeck.git
   cd prdeck

2. Open PRDeck.xcworkspace in Xcode
3. Build & run the PRDeck scheme

Or from the command line:

xcodebuild -workspace PRDeck.xcworkspace -scheme PRDeck -destination 'platform=macOS' build

Usage

Mouse

• Row: click copies PR link, double-click opens PR
• Status icon: click copies the relevant link (PR/checks), double-click opens it
• Right-click a row for a context menu (copy/open PR, checks, CI logs)

Keyboard

• ⌘F: focus search (press Esc to blur)
• ⌘R (or r): refresh
• j / k: move selection
• Enter: open selected PR
• c: open checks for selected PR
• f: open failing check (if available)
• t: toggle “Needs attention” vs “All”
• ⌘+ / ⌘- / ⌘0: zoom in / out / reset
• Esc: close the filters screen

Filters & Appearance

Use the filter icon to open the filters screen:

• PR scope: needs attention vs all
• Repo filtering: include or exclude repositories
• Appearance: theme + show/hide repo/org avatar

Data & Privacy

PRDeck does not collect analytics or send telemetry.

It shells out to gh for GitHub data, and caches a local snapshot for faster startup. See PRIVACY.md for details.

Troubleshooting

“GitHub CLI (gh) not found”

Install it with Homebrew:

brew install gh

PRDeck looks for gh in your PATH plus common locations like /opt/homebrew/bin, /usr/local/bin, and /usr/bin.

Authentication errors

Make sure you’re logged in:

gh auth status
gh auth login

Homebrew tap/install fails

Re-tap and reinstall:

brew untap marcomariscal/prdeck
brew tap marcomariscal/prdeck
brew reinstall --cask prdeck

Development

This repo uses a workspace + Swift Package setup:

PRDeck.xcworkspace/              # Open this file in Xcode
PRDeck/                          # App shell (minimal)
PRDeckPackage/Sources/PRDeckFeature/  # Primary feature code
PRDeckUITests/                   # UI tests

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

Code of Conduct

See CODE_OF_CONDUCT.md.

License

See LICENSE.