octorus 0.1.2

A TUI tool for GitHub PR review, designed for Helix editor users
octorus-0.1.2 is not a library.
Visit the last successful build: octorus-0.1.8

octorus

Crates.io License: MIT

A TUI tool for GitHub PR review with Vim-style keybindings.

Features

  • Browse changed files in a PR
  • View diffs with syntax highlighting (via delta, diff-so-fancy, etc.)
  • Add inline comments on specific lines
  • Submit reviews (Approve / Request Changes / Comment)
  • Fast startup with intelligent caching
  • Configurable keybindings and editor

Requirements

  • GitHub CLI (gh) - Must be installed and authenticated
  • Rust 1.70+ (for building from source)

Installation

cargo install octorus

Or build from source:

git clone https://github.com/ushironoko/octorus.git
cd octorus
cargo build --release
cp target/release/or ~/.local/bin/

Usage

or --repo owner/repo --pr 123

Options

Option Description
-r, --repo <REPO> Repository name (e.g., "owner/repo")
-p, --pr <PR> Pull request number
--refresh Force refresh, ignore cache
--cache-ttl <SECS> Cache TTL in seconds (default: 300)

Keybindings

File List View

Key Action
j / ↓ Move down
k / ↑ Move up
Enter Open diff view
a Approve PR
r Request changes
c Comment only
C View review comments
? Toggle help
q Quit

Diff View

Key Action
j / ↓ Move down
k / ↑ Move up
Ctrl-d Page down
Ctrl-u Page up
c Add comment at line
s Add suggestion at line
q / Esc Back to file list

Comment List View

Key Action
j / ↓ Move down
k / ↑ Move up
Enter Jump to file/line
q / Esc Back to file list

Configuration

Create ~/.config/octorus/config.toml:

# Editor to use for writing comments
editor = "hx"

[diff]
renderer = "delta"
side_by_side = true
line_numbers = true

[keybindings]
approve = 'a'
request_changes = 'r'
comment = 'c'

License

MIT