Skip to content

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.

  1. Read PR progress01

    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
  2. Read PR progress02

    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
  3. Read PR progress03

    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.
Read PR progress

Make the next approval mean something.

Two minutes to install. Free for public repos. The first private repo is on us.