claude-reviewer 0.1.0

Local PR review system for Claude Code - GitHub-style code review without leaving your terminal

Claude Reviewer

A local PR review system for Claude Code. Create pull requests, review diffs with inline comments, and merge changes—all without leaving your terminal.

Why Claude Reviewer?

When working with AI coding assistants like Claude, you often want to review changes before merging them. Claude Reviewer provides:

• GitHub-like code review - View diffs, add inline comments, approve or request changes
• CLI-first workflow - Perfect for AI agents that work in the terminal
• Local & private - All data stays on your machine
• No external dependencies - Just SQLite for storage

Installation

pip install claude-reviewer

Quick Start

1. Create a PR

# On your feature branch with changes
claude-reviewer create --title "Add new feature"

# Output:
# PR #a1b2c3d4 created successfully
# Review URL: http://localhost:3000/prs/a1b2c3d4

2. Start the Web UI

# Start the review interface
claude-reviewer serve

3. Review & Merge

# Check status
claude-reviewer status a1b2c3d4
# Output: changes_requested

# See comments
claude-reviewer comments a1b2c3d4
# Output: [src/app.py:42] Please add error handling here

# After addressing feedback, update the PR
claude-reviewer update a1b2c3d4

# Once approved, merge
claude-reviewer merge a1b2c3d4 --push

Commands

Command	Description
create	Create a new PR from current branch
list	List all PRs
status	Check PR status
comments	Get inline comments with file:line references
show	Show detailed PR information
update	Update PR diff after making changes
merge	Merge an approved PR
serve	Start the web UI
stop	Stop the web UI

CLI Reference

Create a PR

claude-reviewer create \
  --title "Feature: Add user authentication" \
  --description "Implements OAuth2 login flow" \
  --base main \
  --head feature/auth

List PRs

# All PRs
claude-reviewer list

# Filter by status
claude-reviewer list --status pending
claude-reviewer list --status approved
claude-reviewer list --status changes_requested

Get Comments

# Human-readable format
claude-reviewer comments a1b2c3d4

# JSON format (for automation)
claude-reviewer comments a1b2c3d4 -f json

# Only unresolved comments
claude-reviewer comments a1b2c3d4 --unresolved

Merge

# Merge locally
claude-reviewer merge a1b2c3d4

# Merge and push to remote
claude-reviewer merge a1b2c3d4 --push

# Merge and delete source branch
claude-reviewer merge a1b2c3d4 --delete-branch

Web UI

The web interface provides:

• Diff viewer - Side-by-side or unified view
• Inline comments - Click any line to add a comment
• File tree - Navigate between changed files
• Review actions - Approve or request changes

Start it with:

claude-reviewer serve

Then open http://localhost:3000

Configuration

Environment Variables

Variable	Description	Default
CLAUDE_REVIEWER_HOST	Host for review URLs	localhost
CLAUDE_REVIEWER_WEB_DIR	Path to web app	(auto-detected)

Database Location

Data is stored in ~/.claude-reviewer/data.db

Integration with Claude Code

Claude Reviewer is designed to work seamlessly with Claude Code:

# Claude makes changes
git checkout -b feature/new-thing
# ... Claude writes code ...
git commit -m "Add new feature"

# Claude creates PR
claude-reviewer create --title "Add new feature"
# Output: Review URL: http://localhost:3000/prs/abc123

# User reviews in browser, requests changes

# Claude checks for feedback
claude-reviewer status abc123  # "changes_requested"
claude-reviewer comments abc123
# [src/api.py:45] Add input validation

# Claude addresses feedback
# ... makes fixes ...
git commit -m "Add input validation"
claude-reviewer update abc123

# User approves

# Claude merges
claude-reviewer merge abc123 --push

Development

# Clone the repo
git clone https://github.com/benbowles/claude-reviewer
cd claude-reviewer/claude-reviewer-cli

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
make test

# Type checking
make typecheck

# Format code
make format

License

MIT