octorus

日本語

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

Features

• Browse changed files in a PR
• View diffs with syntax highlighting
• Add inline comments on specific lines
• Add code suggestions
• View and navigate review comments with jump-to-line
• Submit reviews (Approve / Request Changes / Comment)
• Fast startup with intelligent caching
• Configurable keybindings and editor
• AI Rally: Automated PR review and fix cycle using AI agents

Requirements

• GitHub CLI (gh) - Must be installed and authenticated
• Rust 1.70+ (for building from source)
• For AI Rally feature (optional, choose one or both):
  • Claude Code - Anthropic's CLI tool
  • OpenAI Codex CLI - OpenAI's CLI tool

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

Initialize Configuration

Create default config files and prompt templates:

or init          # Create config files (skip if exists)
or init --force  # Overwrite existing files

This creates:

• ~/.config/octorus/config.toml - Main configuration file
• ~/.config/octorus/prompts/ - Prompt template directory
  • reviewer.md - Reviewer agent prompt template
  • reviewee.md - Reviewee agent prompt template
  • rereview.md - Re-review prompt template

Keybindings

File List View

Diff View

Note: Lines with existing comments are marked with ●. When you select a commented line, the comment content is displayed in a panel below the diff.

Comment List View

Configuration

Run or init to create default config files, or create ~/.config/octorus/config.toml manually:

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

[diff]
# Syntax highlighting theme for diff view
theme = "base16-ocean.dark"

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

[ai]
# AI agent to use for reviewer/reviewee
# Supported: "claude" (Claude Code), "codex" (OpenAI Codex CLI)
reviewer = "claude"
reviewee = "claude"

# Maximum iterations before stopping
max_iterations = 10

# Timeout per agent execution (seconds)
timeout_secs = 600

# Custom prompt directory (default: ~/.config/octorus/prompts/)
# prompt_dir = "/custom/path/to/prompts"

Customizing Prompt Templates

AI Rally uses customizable prompt templates. Run or init to generate default templates, then edit them as needed:

~/.config/octorus/prompts/
├── reviewer.md    # Prompt for the reviewer agent
├── reviewee.md    # Prompt for the reviewee agent
└── rereview.md    # Prompt for re-review iterations

Templates support variable substitution with {{variable}} syntax:

AI Rally

AI Rally is an automated PR review and fix cycle that uses two AI agents:

• Reviewer: Analyzes the PR diff and provides review feedback
• Reviewee: Fixes issues based on the review feedback and commits changes

How it works

┌─────────────────┐
│  Start Rally    │  Press 'A' in File List View
└────────┬────────┘
         ▼
┌─────────────────┐
│    Reviewer     │  AI reviews the diff
│ (Claude/Codex)  │  → Posts comments to PR
└────────┬────────┘
         │
    ┌────┴────┐
    │ Approve?│
    └────┬────┘
     No  │  Yes
         │   └──→ Done ✓
         ▼
┌─────────────────┐
│    Reviewee     │  AI fixes issues
│ (Claude/Codex)  │  → Commits changes locally
└────────┬────────┘
         │
         ▼
    Next Iteration

Features

• PR Integration: Review comments are automatically posted to the PR
• External Bot Support: Collects feedback from Copilot, CodeRabbit, and other bots
• Safe Operations: Dangerous git operations (--force, reset --hard) are prohibited
• Session Persistence: Rally state is saved and can be resumed
• Interactive Flow: When the AI agent needs clarification or permission, you can respond interactively
• Background Execution: Press b to run rally in background while continuing to browse files

Keybindings (AI Rally View)

License

MIT