cc-pr-reviewer 0.1.1

Textual TUI that lists GitHub PRs awaiting your review and hands them off to Claude Code.

cc-pr-reviewer

A small Textual TUI that lists every open GitHub PR where you are a requested reviewer, and hands the selected PR off to Claude Code with the PR Review Toolkit plugin driving the review.

What it does

• gh search prs --review-requested=@me --state=open fetches your review queue across every repo you have access to.
• Displays them in a scrollable table (repo, number, title, author, age, draft flag).
• Keyboard-driven: pick a PR and either
  • Enter / c — clones the repo (if needed), checks out the PR branch via gh pr checkout, and launches claude inside that working tree with a prompt that invokes the PR Review Toolkit agents.
  • d — full-screen gh pr diff viewer.
  • o — open the PR in your browser.
  • m — include PRs you authored in the list.
  • a — toggle auto-accept (pass --permission-mode acceptEdits to Claude so file-edit prompts don't interrupt the review).
  • p — toggle post-inline (instruct Claude to publish the findings as inline PR review comments via gh api, grouped under one review).
  • r / F5 — refresh.
  • q — quit.

Prerequisites

All prerequisites are validated at startup via check_prereqs(); the TUI refuses to launch until they're satisfied.

1. GitHub CLI — installed and logged in.

   gh auth login
   

2. Claude Code — the claude CLI must be on your PATH.
3. PR Review Toolkit plugin — installed and enabled inside Claude Code (detected via claude plugin list --json):

   claude plugin install pr-review-toolkit
   

   Details: https://claude.com/plugins/pr-review-toolkit
4. git — on your PATH (used for git fetch on repeat reviews).

Install

As a global CLI (recommended)

Install from PyPI with uv or pipx:

uv tool install cc-pr-reviewer
# or
pipx install cc-pr-reviewer

Then run it from anywhere:

cc-pr-reviewer

From source (for development)

uv sync
uv run cc-pr-reviewer
# or
uv run python cc_pr_reviewer.py

Configuration

Env var	Default	Meaning
GH_PR_WORKSPACE	~/gh-pr-workspace	Where repos are cloned for local checkout.

Clones are organised as $GH_PR_WORKSPACE/<owner>/<repo>, so a second review of the same repo reuses the existing clone and just git fetches before checking out the PR.

Keybindings

Key	Action
↑ / ↓	Move through PRs
Enter / c	Clone + checkout + launch Claude Code review
d	View full diff
o	Open PR in browser
m	Toggle inclusion of PRs you authored
a	Toggle auto-accept (--permission-mode acceptEdits)
p	Toggle post-inline (publish findings as inline PR comments)
r / F5	Refresh the list
q	Quit

The current state of the a and p toggles is shown in the status bar and is also printed before Claude launches.

How the Claude launch works

When you press Enter on a row, the TUI suspends itself and runs, in order:

gh repo clone <owner>/<repo>                      # only if not already cloned
git fetch --all --prune                           # otherwise
gh pr checkout <N> --force
claude [--permission-mode acceptEdits] "<review prompt>"

The review prompt asks the PR Review Toolkit to run its six sub-agents (Comment Analyzer, PR Test Analyzer, Silent Failure Hunter, Type Design Analyzer, Code Reviewer, Code Simplifier). Because Claude Code starts in the PR's working tree, it has full file-level context.

If auto-accept (a) is on, --permission-mode acceptEdits is passed so file-edit prompts don't interrupt the review — the same mode you get with shift+tab inside a Claude session.

If post-inline (p) is on, the prompt is extended to ask Claude to publish each finding as an inline review comment via a single POST /repos/{owner}/{repo}/pulls/{n}/reviews call through gh api, so they land grouped under one review.

When you /exit Claude, press Enter and the TUI returns.

Extending

A few natural next steps if you want to go further:

• Add filters (by org, by repo, by author) — gh search prs already accepts --owner, --repo, --author.
• Cache the PR list to disk with a TTL so startup is instant.
• Add a "my authored PRs" tab (--author=@me) to re-use the same UI for tracking your own open PRs.
• Swap the hard-coded REVIEW_PROMPT for a couple of presets bound to different keys (e.g. t for tests-only, s for simplify-only).

Releasing

For maintainers cutting a new PyPI release:

# bump version in pyproject.toml, then:
uv build                              # produces dist/*.whl and dist/*.tar.gz
uvx twine check dist/*                # sanity-check README rendering & metadata
uv publish                            # uploads to PyPI (needs UV_PUBLISH_TOKEN)

Get a PyPI API token from https://pypi.org/manage/account/token/ and set UV_PUBLISH_TOKEN (or pass --token). After publishing, verify from a clean environment:

uv tool install cc-pr-reviewer
cc-pr-reviewer