gh-pr-digest 0.1.0

Developer-friendly digest of GitHub PRs that need your attention

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

1. PRs awaiting your review — Search: is:pr is:open review-requested:<you>
2. Your open PRs — Search: is:pr is:open author:<you>
3. 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