Getting Started Backstory FAQ Download

Frequently Asked
Questions

Everything you need to know about PR and how it works.

01 What is PR?

PR is a native macOS app for reviewing GitHub pull requests. It combines syntax-highlighted diffs, a file tree, inline commenting, and AI-powered insights into a single keyboard-driven interface — so you can stop switching between GitHub's web UI and your editor.

02 What do I need to get started?

You need a Mac running macOS Sonoma or later, the GitHub CLI (gh) authenticated with your account, and at least one supported AI CLI tool installed (Claude, Gemini, or Codex). The app walks you through setup on first launch.

03 Which AI providers are supported?

PR supports four AI providers: Claude CLI, Gemini CLI, Codex CLI, and Apple Intelligence (on-device). You bring your own credentials — PR never stores API keys itself. You can switch providers at any time in Settings.

04 Does PR send my code to external servers?

It depends on the AI provider you choose. If you use Claude, Gemini, or Codex, code context is sent to that provider's API under their terms. If you choose Apple Intelligence, all processing happens entirely on your device — nothing leaves your laptop. PR itself has no backend servers. The app uses Sentry to collect crash reports and performance data so we can fix bugs and improve stability. No source code or review content is included in crash reports.

05 What can the AI actually do during a review?

The AI helps in three ways: File classification automatically labels each changed file as generated, minor, test, or important so you know where to focus. PR summarization gives you a quick bullet-point overview of what changed and why. Review prompt generation turns your inline comments into structured prompts for AI coding assistants.

06 Does PR work with private repositories?

Yes. PR uses the GitHub CLI for authentication, so it has access to every repository your GitHub account can see — including private and organization repos. No additional configuration is needed.

07 Can I submit reviews and comments directly from the app?

Yes. You can write inline comments on specific lines, reply to existing threads, and submit full reviews (approve, request changes, or comment) — all without leaving the app. Your "viewed" file state syncs back to GitHub as well.

08 Is there keyboard / Vim support?

Absolutely. PR is built for keyboard-driven workflows. Vim mode can be enabled in Settings — use j/k to navigate files, v to toggle viewed state, and r to refresh. There are also standard shortcuts like ⌘1/⌘2/⌘3 for filtering file types and ⌘R for refresh.

09 How does PR help me prioritize reviews?

The sidebar groups pull requests into Needs Your Review, Your Pull Requests, and Participating. Aging indicators show orange for reviews waiting 3–7 days and red for 7+ days. PRs without updates for 14+ days are flagged as stale. Combined with AI file classification, you can triage quickly and focus on what matters.

10 Is this app free?

Right now, yes. PR is in public beta and we're not charging anything. Whether it stays that way honestly depends on how much time the author ends up spending on maintenance. The author is also a member of the Stripe user community in Japan (JP_Stripes), so a paid plan may appear someday — possibly when there's something worth bragging about at an event. No promises either way.

11 Is PR available on Windows or Linux?

Not currently. PR is a native macOS app built with SwiftUI and is designed specifically for the Mac. There are no plans for Windows or Linux at this time.

Still have questions?
Try it yourself.

Download PR and see how it fits into your workflow.