GH-PR(1)

💅 NAME

Okay so bestie, gh-pr is literally your main character moment for Managing pull requests — like, the whole PR vibe, handled. 🎀

(This is the GitHub CLI manual, btw — gh's PR corner of the world. ✨)

---

✨ SYNOPSIS

gh pr <command> [flags]

That's it. gh pr, then whatever command your heart desires, then whatever flags you wanna sprinkle on top. Simple slay. 💅

---

🦋 DESCRIPTION

Work with GitHub pull requests. That's the whole assignment. Pull requests! On GitHub! From your terminal! Ngl it's giving productivity icon. 👑

---

👑 GENERAL COMMANDS

These are the big three — the ones you'll be living in fr fr:

• gh-pr-create(1) — makes a brand new pull request ✨
• gh-pr-list(1) — shows you all the pull requests chillin' in a repository 🗂️
• gh-pr-status(1) — shows the status of the pull requests that actually matter to you rn 👀

---

🎯 TARGETED COMMANDS

Now the "you already know which PR you're after" squad — the targeted ones, iykyk 💖:

• gh-pr-checkout(1) — checks out a pull request in git, so you can ~be~ the branch 🧚
• gh-pr-checks(1) — shows the CI status for one single pull request (green or bust 🌈)
• gh-pr-close(1) — closes a pull request, bye bestie 👋
• gh-pr-comment(1) — drops a comment on a pull request 💬
• gh-pr-diff(1) — lets you view the changes in a pull request 🔍
• gh-pr-edit(1) — edits a pull request, glow-up szn ✏️
• gh-pr-lock(1) — locks the pull request conversation 🔒
• gh-pr-merge(1) — merges a pull request, the moment we've all been waiting for 🎉
• gh-pr-ready(1) — marks a pull request as ready for review ⭐
• gh-pr-reopen(1) — reopens a pull request, it's back 💫
• gh-pr-revert(1) — reverts a pull request, undo era 😭
• gh-pr-review(1) — adds a review to a pull request 🫶
• gh-pr-unlock(1) — unlocks the pull request conversation 🔓
• gh-pr-update-branch(1) — updates a pull request branch 🎀
• gh-pr-view(1) — views a pull request, the classic 👑

---

💜 OPTIONS

• -R, --repo <[HOST/]OWNER/REPO> — picks a different repository, using the [HOST/]OWNER/REPO format. Not your usual repo? Not a problem, just point at the right one 🫡

---

🔥 EXIT CODES

Like, how did it go? The numbers tell you:

• 0 — Successful execution 🎉 (slay)
• 1 — Error 💀
• 2 — Command canceled 🙈
• 4 — Authentication required — like, who even are you rn, log in 🔐

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. (Basically: check that specific command's help, bestie, don't come for me. 💅)

---

🌸 EXAMPLE

Here's the vibe in action:

$ gh pr checkout 353
$ gh pr create --fill
$ gh pr view --web

Check out PR 353, create one with --fill, then peek at it straight in the browser with --web. Chef's kiss. 👨‍🍳💋

---

🌈 SEE ALSO

• gh(1) — the mothership 🛸

---

Okay that's the whole page, bestie — GitHub CLI version v2.102.0, dated Oct 2026, and that's a wrap! 🎀💖✨