Install · 2 minutes
Two installs. One CI check.
Add the GitHub App, install the browser extension, and the next pull request your team opens will gate on reading.
- 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
Open GitHub App - 02
Install the extension.
Chrome, Edge, or Firefox. 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 firefox://addons
Get the extension - 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
Open a sample PR
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. The first private repo is on us.