agent-reviews
Manage GitHub PR review comments from the terminal and from AI coding agents.
PR review bots (Copilot, Cursor Bugbot, CodeRabbit, etc.) leave inline comments on your pull requests. agent-reviews gives you a CLI to list, filter, reply to, and watch those comments, plus agent skills that automate the entire triage-fix-reply loop.
Why
gh CLI is fragile for review comments. Agents frequently get the syntax wrong, fail to paginate, and can't reliably detect whether a comment has been replied to. agent-reviews provides a single, purpose-built interface that handles all of this correctly.
Bot reviews create a doom loop. You fix one round of findings, push, and new comments appear. Fix those, push again, more comments. This cycle can eat hours. The included skills solve this with an integrated watcher that keeps fixing and replying until the bots go quiet.
Works in cloud environments. Most solutions rely on local tooling that isn't available in cloud or remote agent environments. agent-reviews works everywhere, so you can kick off a session, let the agent resolve all findings autonomously, and come back to a clean PR.
Install
CLI (npm)
npm install -g agent-reviews
Agent Skills
Three skills are available, each as a slash command (no npm install required):
| Skill | What it resolves |
|---|
resolve-reviews | All comments (human + bot) |
resolve-agent-reviews | Bot comments only (Copilot, Cursor, etc.) |
resolve-human-reviews | Human comments only |
Works with any agent that supports Agent Skills (Claude Code, Cursor, Codex, etc.):
npx skills add pbakaus/agent-reviews@resolve-agent-reviews
Replace resolve-agent-reviews with whichever skill you want. Skills use npx agent-reviews at runtime, so the CLI is fetched automatically.
You can also use both: install the CLI globally for direct terminal use, and a skill for the agent workflow.
Authentication
The simplest method is the GitHub CLI. If you're logged in with gh auth login, agent-reviews picks up the token automatically. No configuration needed.
For cloud/remote environments or HTTPS proxy setups, set GITHUB_TOKEN or GH_TOKEN directly. agent-reviews includes undici ProxyAgent support and will route requests through HTTPS_PROXY automatically when set.
Resolution order (first match wins):
GITHUB_TOKEN environment variableGH_TOKEN environment variable.env.local in the repo rootgh auth token (GitHub CLI)
Custom API host
Set GITHUB_API_URL to point agent-reviews at a GitHub Enterprise host or any API-compatible server (useful for testing, recording, or routing through a local mediator). Defaults to https://api.github.com.
# GitHub Enterprise Server
GITHUB_API_URL=https://github.example.com/api/v3 agent-reviews
# Local API-compatible server
GITHUB_API_URL=http://127.0.0.1:8080 agent-reviews
GraphQL endpoint resolution: agent-reviews uses ${GITHUB_API_URL}/graphql by default. For GitHub Enterprise Server, where REST lives under /api/v3 and GraphQL under /api/graphql on the same origin, the trailing /api/v3 is rewritten to /api/graphql automatically. Set GITHUB_GRAPHQL_URL directly if you need full control over the GraphQL endpoint.
CLI Usage
# List all review comments on the current branch's PR
agent-reviews
# Only unresolved comments
agent-reviews --unresolved
# Only unanswered bot comments
agent-reviews --unanswered --bots-only
# Full detail for a specific comment (diff hunk + replies)
agent-reviews --detail 12345678
# Reply to a comment
agent-reviews --reply 12345678 "Fixed in abc1234"
# JSON output for scripting / AI agents
agent-reviews --json
# Watch for new comments (polls every 30s, exits after 10 min idle)
agent-reviews --watch --bots-only
# Target a specific PR (otherwise auto-detects from branch)
agent-reviews --pr 42
Options
| Flag | Short | Description |
|---|
--unresolved | -u | Only unresolved/pending comments |
--unanswered | -a | Only comments without any replies |
--reply <id> "msg" | -r | Reply to a comment |
--resolve | | Resolve the review thread after replying (use with --reply) |
--detail <id> | -d | Full detail for a comment |
--pr <number> | -p | Target a specific PR |
--json | -j | JSON output |
--bots-only | -b | Only bot comments |
--humans-only | -H | Only human comments |
--expanded | -e | Show full detail for each listed comment |
--watch | -w | Poll for new comments |
--interval <sec> | -i | Poll interval in seconds (default: 30) |
--timeout <sec> | | Inactivity timeout in seconds (default: 600) |
Agent Skills
The skills automate the full PR review resolution workflow:
