GitHub PR Review CLI Extension

Overview

The gh-pr-review extension brings inline PR review comments to the terminal. GitHub's built-in gh tool does not show inline comments or review threads - this extension fills that gap.

Prerequisites

Ensure the extension is installed:

gh extension install agynio/gh-pr-review
# Update existing installation
gh extension upgrade agynio/gh-pr-review

Core Capabilities

1. View Review Threads

To view all reviews and inline comments for a PR:

gh pr-review review view -R owner/repo --pr <number>

Common filters:

• --reviewer <login> - Filter by reviewer
• --states APPROVED,CHANGES_REQUESTED,COMMENTED,DISMISSED - Filter by state
• --unresolved - Show only unresolved threads
• --not_outdated - Exclude outdated threads
• --tail <n> - Keep only last n replies per thread
• --include-comment-node-id - Include GraphQL comment IDs

Example - View unresolved threads from a specific reviewer:

gh pr-review review view -R owner/repo --pr 42 --reviewer alice --unresolved

2. Start a Pending Review

To start a new pending review and get the review ID:

gh pr-review review --start -R owner/repo <pr-number>

Output includes "id": "PRR_..." - save this for adding comments.

3. Add Inline Comments

To add comments to a pending review (requires PRR_... review ID):

gh pr-review review --add-comment \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --path path/to/file.go \
  --line 42 \
  --body "Your comment here" \
  -R owner/repo <pr-number>

4. Reply to Thread

To reply to an existing review thread:

gh pr-review comments reply \
  --thread-id PRRT_kwDOAAABbcdEFG12 \
  --body "Your reply" \
  -R owner/repo <pr-number>

To reply from a pending review, add --review-id:

gh pr-review comments reply \
  --thread-id PRRT_kwDOAAABbcdEFG12 \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --body "Reply from pending review" \
  -R owner/repo <pr-number>

5. Submit Review

To finalize and submit a pending review:

gh pr-review review --submit \
  --review-id PRR_kwDOAAABbcdEFG12 \
  --event APPROVE|COMMENT|REQUEST_CHANGES \
  --body "Review summary" \
  -R owner/repo <pr-number>

6. Manage Threads

List threads:

gh pr-review threads list -R owner/repo <pr-number>
gh pr-review threads list --unresolved --mine -R owner/repo <pr-number>

Resolve/unresolve threads:

gh pr-review threads resolve --thread-id PRRT_... -R owner/repo <pr-number>
gh pr-review threads unresolve --thread-id PRRT_... -R owner/repo <pr-number>

Workflow: Complete Review Cycle

1. Start review: gh pr-review review --start ... -> save PRR_... ID
2. Add comments: gh pr-review review --add-comment --review-id PRR_... ...
3. View current state: gh pr-review review view ...
4. Submit review: gh pr-review review --submit --review-id PRR... --event REQUESTCHANGES ...
5. After fixes, resolve threads: gh pr-review threads resolve --thread-id PRRT_... ...

ID Types

JSON Output Structure

All commands output structured JSON. For detailed schemas, see references/schemas.md.

Resources

references/

• commands.md - Complete command reference with all flags and examples
• schemas.md - JSON output schemas for each command
• agents.md - Agent-focused workflows and best practices