prview

A terminal UI for reviewing GitHub PRs without leaving your terminal. Browse open PRs, read diffs, approve or reject — all from the keyboard.

install

bun install -g prview-cli

or run directly with bun:

bunx prview-cli

setup

on first run prview will ask for a GitHub personal access token.

1. generate a token at github.com/settings/tokens
2. select repo scope
3. paste it into prview — or press [o] to open github directly from the terminal

token is stored at ~/.prview/config.json and never asked again.

usage

cd your-repo
prview

prview detects the github remote automatically from your current directory.

prview --help       # show usage and keyboard shortcuts
prview uninstall    # remove all prview data from ~/.prview

keyboard shortcuts

PR list

| key | action | | ------- | --------------- | | ↑↓ | navigate PRs | | enter | open diff | | a | approve PR | | r | request changes | | q | quit |

diff view

| key | action | | ------------- | ----------------------- | | ↑↓ | scroll lines | | ←→ or j/k | switch files | | v | view full file | | c | comment on current line | | a | approve PR | | r | request changes | | esc | back to PR list | | q | quit |

file view

| key | action | | ----- | ------------ | | ↑↓ | scroll lines | | v | back to diff | | esc | back to diff | | q | quit |

features

• detects github repo automatically from git remote
• browse all open PRs with author and age
• read file diffs with syntax highlighting
• subtle green/red backgrounds for additions and removals
• view full file with changed lines highlighted
• approve or request changes with an optional comment
• inline comments on specific diff lines
• dynamic layout adapts to your terminal size
• first time setup with browser open shortcut

tech stack

• React Ink — terminal UI
• Bun — runtime and package manager
• simple-git — git remote detection
• cli-highlight — syntax highlighting
• figlet — banner text

uninstall

prview uninstall    # removes ~/.prview config
bun remove -g prview

license

MIT