Know which PR to review next. PR Bro ranks pull requests by weighted scoring across your GitHub queries, so you always start with the most important review.
- GitHub Personal Access Token:
reposcope for private repospublic_repofor public only
- Platforms:
- macOS (Intel + Apple Silicon)
- Linux (x64)
brew tap toniperic/tap
brew install pr-bro
To upgrade:
Requires Rust toolchain. Install from rustup.rs.
Download pre-built binaries from the GitHub Releases page. Extract and move to your PATH:
tar -xzf pr-bro-version>-platform>.tar.gz
mv pr-bro /usr/local/bin/
On first run, PR Bro will prompt you with a series of questions to set up your configuration. It will also ask for your GitHub token interactively. To skip the token prompt, set the PR_BRO_GH_TOKEN environment variable.
For the full list of configuration options, see the Configuration Reference.
Use pr-bro --help for all command-line options. Press ? in the TUI for keyboard shortcuts.
Weighted scoring calculates a single priority number for each PR based on age, approval count, size, labels, and whether you’ve reviewed it before, all based on your preferences/configuration. Each parameter can be used to boost or penalize PRs score in any way you see fit.
Interactive TUI shows all PRs sorted by score. Navigate with arrow keys or vim bindings. Press b to see the score breakdown for any PR. Press r to refresh.
Multiple queries let you track different PR sets. Each query can override global scoring rules. First-match-wins when a PR appears in multiple queries.
Snooze PRs to hide them temporarily. Press s to snooze for a custom duration or indefinitely. Snoozed PRs live in a separate tab and don’t clutter your main list.
Score breakdown shows exactly how a PR’s score was calculated. See which factors contributed most. Press b on any PR to open the detail view.
ETag-based HTTP caching reduces GitHub API calls. Auto-refresh only fetches if data changed on the server. Manual refresh bypasses in-memory cache.
See CONTRIBUTING.md for development setup and commit message format.