Docs · Start here
Read PR documentation
Read PR is a GitHub App and browser extension that gates pull request approval until a human has read every changed file. These pages cover setup, configuration, and every state you will see in CI.
The three pieces
- The GitHub App watches your repos and posts a check run named
Read PR / Review completeon every pull request. It starts amber and completes green. - The browser extension runs on GitHub pull request pages. It draws a progress ring beside each file and counts reading time while a file is on screen and the tab is focused.
- The dashboard at readpr.dev/dashboard holds your reading rules, the review log, members, and billing.
The loop, in one paragraph
A teammate opens a pull request. The check posts as Waiting on review. Reviewers open the files view and read. The extension reports time per file in 15-second batches. When every non-excluded file meets its threshold, the check flips to All files read and the merge can proceed. The review log records who read what, and for how long.
Browse the docs
Start here
Product
How it worksHow dwell time is measured, how heartbeats reach the API, and how the check flips.Reading rulesPer-file thresholds, the exact formula, exclusion globs, and per-repo overrides.The checkEvery state of the read-pr check, branch protection, and why billing never blocks a merge.Browser extensionSupported browsers, permissions, the popup, connection tokens, and advanced settings.DashboardWorkspaces, repos, the review log, reviewers, members, and analytics.