Get started
Review pull requests and local changes from the terminal. Navigate with Vim motions, read discussions beside the diff, and submit your review without leaving the keyboard.
Install
Choose one:
sh
brew install tale/tap/prtuish
mise use -g github:tale/prtui@latestsh
cargo install prtuish
nix run github:tale/prtuiOr download a binary from releases.
Authenticate
Install the CLI for your host and sign in. prtui uses its credentials.
| Host | CLI | Sign in |
|---|---|---|
| GitHub | gh | gh auth login |
| GitLab | glab | glab auth login |
Local diffs only need Git, with no host login.
Open a review
From a Git repository:
sh
prtui # pick an open pull or merge request
prtui 123 # open request 123
prtui -R owner/repo 123 # use another repository
prtui diff # inspect local changesIn the picker, use j / k to move, / to filter, and Enter to open. See CLI & configuration for repository namespaces and self-hosted instances.
Your first review
- Press
lto focus the diff; move withj/kand switch files with]/[. - Press
con a line to write a comment, thenEnterto save the draft. - Press
xto mark a file viewed and move to the next unviewed file. - Press
sto open the review form. Choose a verdict withTab, add a summary, and pressEnterto publish.
Press ? for keys in the app. The review guide covers selections, threads, drafts, and reviewing individual commits.