PR Review with gh-agent

Install gh-agent

brew install ataraxy-labs/tap/gh-agent

GITHUB_TOKEN

gh auth login

Workflow

gh-agent pr view --repo OWNER/REPO N --smart

gh-agent pr diff --repo OWNER/REPO N --smart-files

--repo-wide

# Find callers of a removed/renamed symbol
gh-agent pr grep --repo OWNER/REPO N --pattern "removedFunction" --repo-wide

# Find references to a deleted type or enum variant
gh-agent pr grep --repo OWNER/REPO N --pattern "DeletedTypeName" --repo-wide

# Find consumers of a changed interface/config
gh-agent pr grep --repo OWNER/REPO N --pattern "changedOption" --repo-wide --path src/

# Structural search for removed prop usage
gh-agent pr ast-grep --repo OWNER/REPO N --pattern 'oldPropName={$$$}' --repo-wide

• Deleted exports/types — still imported elsewhere?
• Removed function parameters — callers updated?
• Changed constants/config — validators, serializers, tests in sync?
• Removed attributes/flags — renderers, parsers, importers still reference them?

# Read full file at PR branch
gh-agent pr file --repo OWNER/REPO N --path PATH

# Search PR changed files (fast, default)
gh-agent pr grep --repo OWNER/REPO N --pattern "functionName"
gh-agent pr ast-grep --repo OWNER/REPO N --pattern 'useCallback($$$)'

--repo-wide

--base

1. Generate a high-level summary of the changes in the diff.
2. Go file-by-file and review each changed hunk.
3. Comment on what changed in that hunk (including the line range) and how it relates to other changed hunks and code, reading any other relevant files. Also call out bugs, hackiness, unnecessary code, or too much shared mutable state.
4. Flag any

   --repo-wide

   hits from impact analysis that indicate broken callers, stale references, or missing updates outside the PR.
5. Categorize findings by severity: CRITICAL, HIGH, MEDIUM, LOW.

# Post comments (line must appear in diff — use --json to check)
gh-agent pr review --repo OWNER/REPO N --comments-file /tmp/review.json
gh-agent pr diff --repo OWNER/REPO N --json   # commentable lines map

# Post suggestion
gh-agent pr suggest --repo OWNER/REPO N --file F --line-start S --line-end E --replacement "code"

Commands

pr view --repo R N --smart

pr view --repo R N --json

pr diff --repo R N --smart-files

pr diff --repo R N --file F

pr diff --repo R N --stat

pr diff --repo R N --json

pr file --repo R N --path P

pr grep --repo R N -p PAT

pr grep --repo R N -p PAT --repo-wide

pr ast-grep --repo R N -p PAT

pr ast-grep --repo R N -p PAT --repo-wide

pr review --repo R N -c F

pr suggest --repo R N ...

Rules

1. --smart

   first. Never read all diffs blindly.

2. --smart-files

   for diffs. One call, no manual file list.
3. Skip MECHANICAL. Don't read or comment on them.
4. NEVER use local files. Always use

   pr file

   ,

   pr grep

   , or

   pr ast-grep

   .
5. Always do impact analysis. After reading diffs,

   --repo-wide

   grep for every deleted/renamed export, removed type, and changed public API. This catches broken callers outside the PR.
6. Search incrementally. PR files first →

   --repo-wide

   only if needed for additional context.
7. Review in-skill. Do not hand off to external review tools. Summarize, go hunk-by-hunk, flag bugs and stale references, and categorize by severity.
8. Post only when asked. Present findings in chat; user decides when to post.