Terminal UI for keeping up with your open GitHub pull requests across repositories.

ghui gives you one keyboard-driven place to review PR details, inspect diffs, manage labels, toggle draft state, merge, open PRs in GitHub, and copy PR metadata without leaving the terminal.

npm install -g @kitlangton/ghui

Requirements:

• Bun runtime installed
• GitHub CLI installed and authenticated with gh auth login

Run it from anywhere:

ghui

Clone, install, and link:

git clone https://github.com/kitlangton/ghui.git
cd ghui
bun install
bun link

• GHUI_AUTHOR: author passed to gh search prs, defaults to @me
• GHUI_PR_FETCH_LIMIT: max PRs fetched, defaults to 200
• GHUI_INCLUDE_REVIEW_REQUESTED: include PRs requesting your review, defaults to false
• GHUI_INCLUDE_ORG_PRS: include open PRs from organizations you belong to, defaults to false
• GHUI_SHOW_PR_SOURCE: show authored/review-requested source in the UI, defaults to false
• GHUI_GROUP_BY_ORG: group the list by org and then repo, defaults to false

Example:

GHUI_AUTHOR=@me ghui

You can also copy .env.example to .env and edit the values locally.

• up / down: move selection
• k / j: move selection
• gg / G: jump to first or last pull request
• ctrl-u / ctrl-d: page up or down
• /: filter
• enter: expand details
• esc: return from expanded details or close modal
• r: refresh
• d: view diff
• s: toggle draft or ready-for-review state
• m: merge
• t: choose theme
• l: manage labels
• o: open PR in browser
• y: copy PR metadata
• q: quit