pr-review-ci

pr-review-ci

CI-mode pull request review. Posts an inline GitHub review with a formal APPROVE / REQUEST_CHANGES verdict. Runs in GitHub Actions on a PR.

Usage

/pr-review-ci <PR_NUMBER>

Pre-conditions:

• CI=true OR GITHUB_ACTIONS=true MUST be set in the environment.
• A <PR_NUMBER> argument is required.
• --watch is not supported (no cron in CI).
• --local is not supported (use /pr-review-local for that).

If any pre-condition fails, abort with a clear error and exit 1.

Step 1: Validate environment + arguments

if [ "$CI" != "true" ] && [ "$GITHUB_ACTIONS" != "true" ]; then
  echo "pr-review-ci must run in CI (CI=true or GITHUB_ACTIONS=true). Use /pr-review-gh for local-PR review." >&2
  exit 1
fi
if [ -z "${1:-}" ]; then
  echo "pr-review-ci requires a PR number." >&2
  exit 1
fi

Parse <OWNER> and <REPO> from git remote get-url origin (handles both [email protected]:owner/repo.git and https://github.com/owner/repo.git).

Step 2: Fetch PR details

PR_JSON=$(gh pr view <PR_NUMBER> --json title,body,baseRefName,headRefName,headRefOid,state 2>&1)
if [ $? -ne 0 ]; then
  echo "gh pr view <PR_NUMBER> failed: $PR_JSON" >&2
  exit 1
fi

Extract <BASE_BRANCH>, <HEAD_BRANCH>, <HEAD_SHA>, state. Validate that all three branch/SHA fields are non-empty AND not whitespace-only (use [ -z "${X//[[:space:]]/}" ] — bare [ -z "$X" ] lets whitespace pass). If state is not OPEN, inform the user and stop. Then fetch the base branch and the PR head by pull ref (works for fork PRs, where <HEAD_BRANCH> does not exist under origin):

git fetch origin <BASE_BRANCH> "+refs/pull/<PR_NUMBER>/head:refs/remotes/origin/pr/<PR_NUMBER>"

Verify git rev-parse origin/pr/<PR_NUMBER> equals <HEAD_SHA>; if not, the PR moved mid-run — stop and report. Also verify git rev-parse HEAD equals <HEAD_SHA> (the engine reads full file contents from the worktree, so it must be at the reviewed revision); if not, run git checkout --detach <HEAD_SHA> before continuing.