Skip to content

brrock/review-cli

Repository files navigation

review-cli

⚡ CLI powerhouse for GitHub PR reviews. Inspect threads, filter by reviewer, export JSON—works perfectly with agents and skills.

Bun npm version npm downloads

Requirements

  • Bun
  • GitHub CLI authenticated with access to the target repo
  • Run the command from a local checkout of the GitHub repository whose PR you want to inspect

Install

# globally
bun i -g review-cli
# install skills
bunx skills add brrock/review-cli
# in this project
bun install

Usage

bunx review-cli [pr-number] [options]

If pr-number is omitted, the CLI asks gh for the current PR on your branch.

To add agent skills run

bunx skills add brrock/review-cli

Options

  • --filter <number> shows only the first matching review threads after other filters are applied.
  • --include-resolved includes resolved threads. By default, only unresolved threads are shown.
  • --just-reviews omits pull request metadata and prints review data only.
  • --user <login> filters to comments authored by that GitHub user. Repeat the flag to match multiple users.
  • --json prints structured JSON instead of the default human-readable report.
  • --help prints usage information.

For AI agents and scripts, prefer --json --just-reviews unless you specifically need PR metadata such as the title, branch names, or PR URL.

Examples

Show unresolved review threads for the current PR:

bunx review-cli

Show unresolved threads for PR 123:

bunx review-cli 123

Show only comments from specific reviewers:

bunx review-cli --user monalisa --user hubot

Show only the first 5 matching review threads without PR metadata:

bunx review-cli --filter 5 --just-reviews

Include resolved threads and emit JSON:

bunx review-cli 456 --include-resolved --json

Output

Default output is a readable terminal report with PR metadata first, followed by matching threads and comments. Use --just-reviews when you only want the review data section.

Use --json when you want to pipe the result into another tool. For agent-oriented review triage, --json --just-reviews is usually the best default:

bunx review-cli --json --just-reviews

About

⚡ CLI for GitHub viewing PR reviews. Filter threads by reviewer, export JSON, built with Bun. Perfect for agents & humans. Skills included.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors