Install · 2 minutes
Install Read PR on GitHub in two minutes.
Two installs, one CI check. Add the GitHub App, add the browser extension, and the next pull request your team opens will gate on reading. New here? Read what Read PR for GitHub does first.
- 01
Add the GitHub App.
Pick which organization and which repos Read PR watches. We register a required status check called read-pr/reviewed.
# Optional: gate merges on the check $ gh api repos/:owner/:repo/branches/main/protection \ --field required_status_checks.contexts[]=read-pr/reviewed
Install on GitHub - 02
Install the extension.
Chrome, or any Chromium browser that installs from the Chrome Web Store. The extension injects a progress ring beside each file in GitHub's diff view and tracks dwell time only while the file is on screen and the tab is focused.
chrome://extensions → Read PR → enabled
Add to Chrome - 03
Open a PR. Review.
The first PR after install becomes the smoke test. Open the files view, scroll, read. The status check moves from amber to green when each file has met its threshold.
read-pr/reviewed ✓ Read by @ian — 4m 12s across 7 files
Stuck? Three things to check.
- No status check? The repo isn't in the watched list. Re-run the GitHub App install and tick the repo.
- Ring not appearing? Make sure the extension is enabled on github.com and reload the PR files page.
- Stuck on amber? Check the per-file threshold. Generated files and lockfiles are excluded by default — paths matching them won't move the count.
Make the next approval mean something.
Two minutes to install. Free for public repos. Private repos start with 14 days on us, no card.