pr-status

name	pr-status
description	Check status of a PR - CI, reviews, merge readiness
allowed-tools	Bash
argument-hint	["PR-URL-or-number"]

PR Status

Check the full status of a pull request: CI checks, review status, and merge readiness.

Arguments

• $1 (optional): PR URL or number. If omitted, detects the PR for the current branch.

Instructions

Step 1: Fetch PR details

gh pr view ${1:+$1} --json number,title,state,author,baseRefName,headRefName,additions,deletions,changedFiles,mergeable,reviewDecision,statusCheckRollup,reviews,url 2>/dev/null

Step 2: Fetch CI checks

gh pr checks ${1:+$1} 2>/dev/null

Step 3: Fetch review details

gh pr view ${1:+$1} --json reviews --jq '.reviews[] | "\(.author.login): \(.state)"' 2>/dev/null

Output Format

### PR #[number]: [title]

**URL**: [url]
**Author**: @[author]
**Branch**: [head] → [base]
**State**: [Open/Closed/Merged]

---

| Check       | Status                    |
|-------------|---------------------------|
| CI          | PASS / FAIL / PENDING     |
| Reviews     | X/Y approved              |
| Mergeable   | Yes / No / Conflicting    |

---

#### CI Checks
| Name                | Status  | Duration |
|---------------------|---------|----------|
| [check-name]        | PASS    | 3m 12s   |
| [check-name]        | FAIL    | 1m 45s   |

#### Review Status
| Reviewer      | Decision          |
|---------------|-------------------|
| @[reviewer]   | APPROVED          |
| @[reviewer]   | CHANGES_REQUESTED |
| @[reviewer]   | PENDING           |

---

#### Action Items
1. [What needs to happen before this can merge]
2. [Any failing checks to investigate]
3. [Any reviews still pending]

Notes

• If no PR exists for the current branch, inform the user
• Highlight any failing CI checks prominently
• Call out stale reviews (approved but with new commits since)