gh-prlist

Configurable GitHub pull-request monitoring with clickable macOS notifications. The PyPI package is gh-prlist (prlist and pr-list are taken or blocked as too similar). The installed commands are gh-prlist, pr-list, and prlist. It requires the GitHub CLI (gh) to be installed and authenticated.

uvx gh-prlist setup
uvx gh-prlist list
uvx gh-prlist monitor
uvx gh-prlist monitor --own
uvx gh-prlist monitor --team
uvx gh-prlist monitor --own --team

setup writes TOML configuration to ~/.prlist. Command-line options override that file; run prlist <command> --help for all overrides.

The default policies show your open non-draft PRs with failing CI and non-draft team-review requests with green CI and no explicit merge conflict. monitor checks every ten minutes and writes a clickable report to ~/.cache/prlist/prs.html.

Each source can independently filter CI (green, failing, any) and mergeability (not_conflicting, conflicting, any). Notifications can include own PRs, team PRs, or both. Change-only notification state persists across monitor restarts.

Failure ignores are configurable per source as case-insensitive check-name substrings. They can be entered during setup or supplied repeatedly:

gh-prlist monitor --own --own-ignore-failure "Post Plan Checks"

For clickable notification actions on macOS, install terminal-notifier. Without it, notifications fall back to osascript.