gh-pr-digest
Developer-friendly digest of GitHub PRs that need your attention.
Install
pip install gh-pr-digest
Auth (GITHUB_TOKEN)
Set a personal access token (classic or fine-grained with Issues/PR read):
export GITHUB_TOKEN=ghp_your_token_here
# or
export GH_TOKEN=ghp_your_token_here
If neither is set, the CLI falls back to gh auth token when the GitHub CLI is available.
60-second demo
pip install gh-pr-digest
export GITHUB_TOKEN=ghp_... # or: gh auth login
# Human-readable digest for the authenticated user
gh-pr-digest
# Limit to one repo + machine output
gh-pr-digest --repo owner/name --json
# Also surface your open PRs with failing combined commit status
gh-pr-digest --with-ci
What you get
- PRs awaiting your review — Search:
is:pr is:open review-requested:<you> - Your open PRs — Search:
is:pr is:open author:<you> - Failing checks (optional
--with-ci) — Combined commit status for your open PRs
Exit codes
| Code | Meaning |
|---|---|
0 |
Success |
1 |
Usage / HTTP / rate-limit errors |
2 |
Authentication error |
Development
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest
License
MIT
1 maintainer
Release files for gh-pr-digest 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gh_pr_digest-0.1.0.tar.gz | 8.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gh_pr_digest-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.0 kB
Release files / gh_pr_digest-0.1.0.tar.gz
| Download URL | gh_pr_digest-0.1.0.tar.gz |
|---|---|
| Size | 8.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f23365c7afce3a26528e63a7576a94c1015a952f923d6ec41daa267260f57ad7
|
|
BLAKE2b-256 checksum How to use checksums |
17a7d7b5d4a10f5b426942de55321872222289cc521b454202e2c773ffa9deef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / gh_pr_digest-0.1.0-py3-none-any.whl
| Download URL | gh_pr_digest-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ae95bebc1c3bd8df387c3f4e721bb582674efd8f657e72a4a79012eb71b226cf
|
|
BLAKE2b-256 checksum How to use checksums |
ad998713a28f3977fa80de7e224ebf61675dbcc4b1eb922f03ab61ab139449f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
