prowl

A tiny terminal radar for your GitHub pull requests.

A tiny terminal dashboard that watches a GitHub repo's open PRs, its merge queue, your recently merged PRs, and the commits you've shipped per release. It refreshes on an interval and rings the terminal bell the moment one of your PRs merges or an open PR's CI/merge status changes — and flags whatever changed. On startup it paints instantly from a local cache, then refreshes in the background.

It talks to the GitHub API directly. On first run it walks you through a one-time browser device login (or set GITHUB_TOKEN).

Status is a single Catppuccin-colored glyph. On a TTY, prowl uses Nerd Font icons (pass, fail, pending, conflicts, merged); with --ascii (or when piped) it falls back to P pass, x fail, . pending, ! conflicts, m merged. Each PR number is a clickable link to the PR. Long titles are truncated (with a ⋯) and the whole view is kept within 120 columns.

Install

brew install --cask caarlos0/tap/prowl    # homebrew
npm install -g @caarlos0/prowl            # npm
npx @caarlos0/prowl                       # run without installing
cargo install --path .                    # from source

Login

On first use, prowl runs a one-time GitHub device login and caches the token in your OS keyring (a chmod 600 file on Linux/headless). You can also trigger it explicitly, or skip it entirely with an env var:

prowl --login                 # authorize once in the browser
GITHUB_TOKEN=… prowl --once    # or just bring your own token

Usage

prowl                     # watch the repo in the current directory
prowl --repo owner/name   # watch a specific repo
prowl --once              # render once and exit

While watching, press r to refresh now, ? to toggle the help legend, and Ctrl-C to quit. A footer at the bottom (r refresh (every 5m) - ? help) shows the keys and the refresh interval. The legend is a full reference of every status glyph and STATE value.

Run prowl --help for all flags (interval, --only, merged window, etc.).