gh-pr-list - List pull requests in a repository
Contents
Description
List pull requests in a GitHub repository.
The search query syntax is documented here:
⟨https://docs.github.com/en/search-github/searching-on-github/searching-issues-and-pull-requests⟩
Example
List PRs authored by you
$ gh pr list --author "@me"
List only PRs with all of the given labels
$ gh pr list --label bug --label "priority 1"
Filter PRs using search syntax
$ gh pr list --search "status:success review:required"
Find a PR that introduced a given commit
$ gh pr list --search "<SHA>" --state merged
Name
gh-pr-list - List pull requests in a repository
Options
--app<string>
Filter by GitHub App author
-a, --assignee<string>
Filter by assignee
-A, --author<string>
Filter by author
-B, --base<string>
Filter by base branch
-d, --draft
Filter by draft state
-H, --head<string>
Filter by head branch
-q, --jq<expression>
Filter JSON output using a jq expression
--json<fields>
Output JSON with the specified fields
-l, --label<strings>
Filter by label
-L, --limit<int>(default30)
Maximum number of items to fetch
-S, --search<query>
Search pull requests with query
-s, --state<string>(default"open")
Filter by state: {open|closed|merged|all}
-t, --template<string>
Format JSON output using a Go template; see "gh help formatting"
-w, --web
List pull requests in the web browser
Options Inherited From Parent Commands
-R, --repo<[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format
See Also
gh-pr(1) Jan 2025 GH-PR-LIST(1)
Synopsis
ghprlist[flags]
