Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

gh-mine

Glance at your open GitHub pull requests across all your repos.

A minimalist gh extension that prints a colored cross-repo table of your open PRs and lets you pick one with fzf. Designed for the "where do my PRs stand right now?" use case — no full-screen TUI, no waiting.

Why?

gh-dash is a great full-screen TUI for managing PRs and issues. gh pr list only works in the current repo. gh-mine fills the gap: a fast colored cross-repo table you can glance at, plus an optional fzf picker — no full-screen TUI to wait for.

Install

gh extension install olivierlemoal/gh-mine

Usage

gh mine                       # interactive picker (default)
gh mine --table               # plain colored table (scriptable)
gh mine --owner ACME          # filter by repository owner
gh mine --limit 30            # max PRs to fetch
gh mine --no-color            # disable ANSI colors
gh mine --no-links            # disable OSC 8 hyperlinks
gh mine --version             # print version

In the default picker mode, type to filter and Enter opens the targeted PR in your browser while leaving the picker open, so you can open several PRs in a row; Alt+Enter opens the PR and quits (one-shot); Esc quits.

In --table mode, the PR number is wrapped in an OSC 8 hyperlink — Ctrl+click to open it in supported terminals (Ghostty, WezTerm, kitty, iTerm2, modern GNOME Terminal, etc.).

Requirements

  • gh — authenticated (gh auth login)
  • jq — JSON parsing
  • fzf (optional) — for the interactive picker. If fzf is not installed, gh mine falls back to --table mode automatically.

On macOS:

brew install jq fzf

On Debian/Ubuntu:

sudo apt install jq fzf

Features

  • Fast — single GraphQL query (PR data + CI status), no TUI to initialize.
  • Cross-repo — shows all your open PRs across every repo you contribute to.
  • CI status — at-a-glance check rollup state (success / failure / pending).
  • Color-coded agefresh (green), old (>1mo) (yellow), ⚠ stale (>6mo) (red).
  • Draft markers — drafts shown in gray with a * suffix.
  • Security highlight — PRs carrying a security label are flagged in red.
  • Clickable PR numbers — OSC 8 hyperlinks on supported terminals.
  • Pipe-friendly — auto-falls back to --table mode on non-TTY (no ANSI bytes leaking into your scripts).
  • Cross-platform date handling — works on Linux (GNU date) and macOS (BSD date).

Note: the CI column uses Nerd Font glyphs. If your terminal doesn't have a Nerd Font configured, you'll see boxes — install a Nerd Font or fall back to looking at age & security indicators.

Examples

Filter by owner:

$ gh mine --owner my-org --table
Repo                  #       Title                                       CI  Updated     Age
---------------------------------------------------------------------------------------------------
my-org/api            #421    feat: add /healthz endpoint                 ✓   2026-04-28  fresh
my-org/web            #89     fix(security): sanitize user input          ✗   2026-03-12  old (>1mo)
my-org/legacy         #3      chore: bump deps                            ·   2025-08-04  ⚠ stale (>6mo)

3 open PR(s) (owner: my-org) — 1 stale ⚠

Pipe into another tool:

gh mine --table --no-color | grep "fix(security)"

License

MIT — see LICENSE.

About

Glance at your open GitHub pull requests across all your repos in under 2s

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages