gh-review-0.1.1 is not a library.

gh-review

Terminal UI for reviewing GitHub pull requests. View diffs (unified and side-by-side), comment on specific lines, expand context, and approve — all without leaving the terminal.

gh-review screenshot

Install

cargo install gh-review

Requires the GitHub CLI (gh) to be installed and authenticated.

Usage

gh-review <OWNER/REPO> <PR_NUMBER>

gh-review octocat/hello-world 42

With gh-dash

gh-dash is a terminal dashboard for GitHub PRs, issues, and notifications. gh-review is designed to complement it — use gh-dash to browse and triage, press a key to jump into gh-review for deep code review.

Setup

Install gh-dash if you haven't already:
```
gh extension install dlvhdr/gh-dash
```

Add a custom keybinding to ~/.config/gh-dash/config.yml:

keybindings:
  prs:
    - key: R
      name: review (gh-review)
      command: >
        gh-review {{.RepoName}} {{.PrNumber}}

{{.RepoName}} and {{.PrNumber}} are template variables that gh-dash fills in with the currently selected PR.

Run gh-dash:
```
gh dash
```
Navigate to a PR and press R. gh-dash suspends and gh-review takes over the terminal. When you quit gh-review (q), you're back in gh-dash.

Workflow

gh-dash (browse PRs)
  │
  ├─ R  → gh-review (diff, comment, approve)
  ├─ D  → delta side-by-side diff (quick read-only view)
  ├─ d  → unified diff in pager
  └─ V  → approve directly

Keybindings

Navigation

Key	Action
`j` / `k` / `↑` / `↓`	Scroll line
`gg` / `G`	Go to first / last line
`Ctrl+D` / `Ctrl+U`	Half page down / up
`Ctrl+F` / `Ctrl+B`	Full page down / up
`H` / `M` / `L`	Cursor to screen top / middle / bottom
`]` / `}`	Next hunk
`[` / `{`	Previous hunk
`)` / `(`	Next / previous change
`n` / `N`	Next / previous file
`zz` / `zt` / `zb`	Center / top / bottom cursor in viewport
`Tab`	Switch focus between file list and diff

Diff

Key	Action
`t`	Toggle unified / side-by-side view
`e`	Expand context around cursor (+10 lines)

Review

Key	Action
`c`	Comment on current line
`Ctrl+S`	Save comment (in comment editor)
`Esc`	Cancel comment
`a`	Submit review — approve
`r`	Submit review — request changes
`s`	Submit review — comment only

Comments are batched into a pending review and submitted together when you press a, r, or s. This matches GitHub's review model.

Other

Key	Action
`o`	Open PR in browser
`?`	Show help overlay
`q`	Quit

Architecture

src/
  main.rs              CLI entry point (clap)
  app.rs               Root state, event loop, key dispatch
  event.rs             Async event channel (crossterm + tokio)
  gh.rs                GitHub API via gh CLI subprocess
  types.rs             Domain types
  theme.rs             Colors and styles
  diff/
    parser.rs          Parse unified diff into structured hunks
    renderer.rs        Render unified + side-by-side views
    expand.rs          Fetch and splice expanded context
  components/
    diff_view.rs       Scrollable diff viewport
    file_picker.rs     File list sidebar
    comment_input.rs   Inline comment textarea popup
    review_bar.rs      Bottom status bar
    help.rs            Keybinding help overlay

All GitHub API calls go through the gh CLI, reusing your existing authentication. No tokens or OAuth configuration needed.

Roadmap

See docs/ROADMAP.md for planned features including search, stacked PR support, syntax highlighting, and more.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines on how to get started, submit pull requests, and report issues.

This project follows the Contributor Covenant Code of Conduct.

License

MIT

gh-review 0.1.1