gh-pr-list - List pull requests in a repository
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⟩
- --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> (default 30)
- 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
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