Command referencegh pr status
gh pr status command (Linux & Windows / GitHub CLI)
What it does
Show pull request status relevant to your work: current branch, created PRs, and review requests. When people search for gh pr status, they usually want practical GitHub CLI flags, safe examples, and how this subcommand fits everyday PR and repo workflows on Linux, Windows, and macOS. Syntax, options, and copyable examples are below.
Show pull request status relevant to your work: current branch, created PRs, and review requests.
Syntax
gh pr status [flags]
Common options
| Flag / option | Meaning |
|---|---|
| (none) | Summarizes PRs related to you without extra flags. |
| -R, --repo | Select another repository (OWNER/REPO). |
Practical examples
Team overview
gh pr status
Summarizes PRs you authored and PRs waiting on your review.
Another repo
gh pr status -R OWNER/REPO
Shows PR status for a repository other than the current cwd.
Common mistakes
- Expecting repo-wide CI dashboards — this focuses on your PR involvement.
- Using status instead of `gh run list` when you need Actions run details.
Related commands
- gh pr listList pull requests in a repository with state, author, and search filters.
- gh pr viewDisplay pull request metadata, body, and checks in the terminal or browser.
- gh run listList recent GitHub Actions workflow runs for the repository.
- gh pr checksShow GitHub Actions and status-check results for a pull request.
- gh auth loginAuthenticate the GitHub CLI with GitHub.com or GitHub Enterprise so other gh commands can run.
- gh pr createCreate a pull request from the current branch with title, body, reviewers, and base branch options.
- gh pr mergeMerge a pull request using merge commit, squash, or rebase strategies.
- gitTrack source history and collaborate through distributed repositories.
FAQ
What does gh pr status do in GitHub CLI?
Show pull request status relevant to your work: current branch, created PRs, and review requests.
Does gh pr status work on Windows and Linux?
Yes. The GitHub CLI (`gh`) runs on Linux, Windows, and macOS with the same subcommand syntax after you authenticate with `gh auth login`.
What is a practical gh pr status example?
Try `gh pr status` — Summarizes PRs you authored and PRs waiting on your review.
Do I need a token in the command line for gh pr status?
Prefer `gh auth login` so credentials stay in the system keyring or secure storage. Avoid pasting personal access tokens into shell history.
Browse the full Linux and Windows command reference to search more bash, CMD, PowerShell, Conda, and GitHub CLI commands.