gh-tui View source

OPEN SOURCE · POWERED BY THE GH CLI

Your GitHub cockpit.
Still your terminal.

A keyboard-driven workspace for pull requests, diffs, checks, issues, Actions, and repos. Get the whole picture, take the next action, and stay in flow.

gh extension install navbytes/gh-tui

Install & run Explore on GitHub

Already using gh? Your existing login is all you need. macOS & Linux · MIT licensed

REAL PRODUCT SCREENSHOT01 / 03
gh-tui in a real public repository, with pull requests and other panels beside a PR overview
Swipe to inspect ↔Enter drill in f focus diff x actionsReal public repo · login “you” · Open full screenshot ↗
ONE WORKSPACE / MANY REPOSITORIESDiscover the flow
01

Use your existing gh login.
No token to paste into another app.

02

See the exact command.
Nothing runs until you confirm it.

03

Inspect the trail.
A command log shows what ran.

THE PRODUCT / NO CONTEXT SWITCH REQUIRED

The work is already here.
Now the workflow is too.

gh-tui brings the GitHub surfaces you visit all day into one focused terminal UI. Go from a list to the line, check, or thread that needs you.

01 / REVIEW

Stay with the code.

Move through PR files, commits, checks, and comments. Switch between split and unified diffs, follow review threads, and mark files viewed.

Real gh-tui split diff with highlighted changes
REAL PUBLIC-REPO SCREENSHOT
02 / GLOBAL HOME

All your repos. One starting point.

Launch outside a repo to see review requests, your PRs, issues, and favorites. Browse or narrow the scope without changing directories.

01 Review requested ↗02 My PRs ↗03 Issues ↗04 Repos ↗

Global-home screenshots in the gallery use synthetic demo data.

03 / ACTIVITY

Follow what happens next.

See workflow runs, drill into failed checks, triage issues, browse releases, and read notifications across repos.

Pull requests REVIEW Workflow runs CHECK Releases BROWSE

THE FLOW / FROM OPEN TO DONE

A few keys.
A complete review.

Navigation stays fast because every step has a direct path. Mouse support is there when you want it.

Explore every keybinding
  1. 01
    gh tui

    Open your workspace

    Start in a repo, or launch anywhere for your cross-repo home.

  2. 02
    Enterf

    Drill in. Focus the diff.

    Open a PR, move through its details, and zoom into code when it matters.

  3. 03
    xy

    Act with a seatbelt

    Open the action menu. Review the exact gh command, then confirm with y.

DESIGNED FOR TRUST

Power you can
see before you use.

gh-tui shells out to the GitHub CLI for authentication and actions. The confirmation popup previews the command before a write, and L opens the command log.

gh-tui / confirm action

Run this command? [y yes, n/Esc no]

gh pr review 5 -R owner/repo --approve
Inspect a real confirmation screen ↗

Illustrative command; the linked screen shows a real confirmation.

01

Your GitHub CLI session

Authentication stays with gh; there is no separate token setup for gh-tui.

02

A visible action trail

The command log records gh and git commands the app ran.

03

Verifiable releases

Release assets include checksums and build provenance attestations.

START HERE / QUICK SETUP

Install it.
Keep moving.

gh-tui is a GitHub CLI extension. Authenticate with gh, install once, then launch from any directory.

Prebuilt for macOS (arm64, amd64) and Linux (arm64, amd64; glibc 2.35+). Windows is unsupported.
Cargo install and release verification
QUICK STARTgh CLI
01
Authenticate with GitHubgh auth login
02
Install the extensiongh extension install navbytes/gh-tui
03
Launch the workspacegh tui

Tip: run it outside a repo for global home.Configuration ↗