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