ghui

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, leave diff comments, manage labels, toggle draft state, merge, cut releases, open PRs in GitHub, and copy PR metadata without leaving the terminal.

Install

Homebrew is the recommended install path on macOS and Linux. It installs a standalone ghui binary, so you do not need Bun or npm at runtime.

brew install kitlangton/tap/ghui

Upgrade with:

brew upgrade ghui

Or install with npm:

npm install -g @kitlangton/ghui

The npm package also installs a platform-specific binary package and does not require Bun.

Requirements:

• GitHub CLI installed and authenticated with gh auth login

Run it from anywhere:

ghui

Local Development

Clone, install, and link:

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

With Nix flakes:

nix develop
bun install
bun run dev

Configuration

• GHUI_PR_FETCH_LIMIT: max PRs fetched, defaults to 200

Example:

GHUI_PR_FETCH_LIMIT=100 ghui

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

Keybindings

• 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
• tab / shift-tab: switch PR queue
• ctrl-p / cmd-k: open the command palette
• /: filter
• enter: expand details; normal PR actions still work while details are expanded
• esc: return from expanded details, leave diff/comment mode, or close modal
• r: refresh
• d: view stacked diff for all changed files
• shift-r: review or approve the selected pull request
• up / down / pageup / pagedown: move comment target while viewing a diff
• enter: open a commented diff line, or start a comment on an uncommented line
• v: start or clear a multi-line diff comment range
• n / p: jump between diff comment threads
• f: open the changed-files navigator while viewing a diff
• left / right: choose the deleted or added side while in split diff comment mode
• [ / ]: switch files while viewing or commenting on a diff
• s: toggle draft or ready-for-review state
• m: merge
• x: close with confirmation
• t: choose theme, including System to match your terminal colors
• l: manage labels
• o: open PR in browser
• y: copy PR metadata
• q: quit

Review submission:

• Press shift-r to open the review modal.
• Use j / k or up / down to choose Comment, Approve, or Request changes.
• Press enter to move to the optional summary area.
• Press enter again to submit, or shift-enter to insert a newline.
• Press esc from the summary to return to action selection; press esc from action selection to cancel.

Releases

Open the command palette and pick Releases… (or New release…) to manage releases for the active repository without leaving the terminal.

In the releases overlay:

• j / k, gg / G: navigate releases
• enter: view a release (body + assets)
• n: cut a new release
• e: edit the selected release
• shift-d: delete the selected release (with confirmation)
• o: open in browser
• y: copy URL
• ] / r: load more / refresh
• esc: back to list / close

In the release form:

• tab / shift-tab: move between fields (tag, target, title, description, pre-release, latest)
• space / enter: toggle the focused checkbox or tri-state
• ctrl-g: generate release notes (only fills empty title and body, matching github.com)
• ctrl-s: save as draft
• ctrl-↵: publish (or save the edit when editing an existing release)
• esc: cancel and return to the releases overlay

Asset uploads are still done from the GitHub web UI for now — use o to jump to the draft release in the browser when you need to attach binaries.