gh-pr-list - Man Page

List and filter pull requests in this repository


gh pr list [flags]


-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 labels

-L,  --limit <int>

Maximum number of items to fetch

-S,  --search <query>

Search pull requests with query

-s,  --state <string>

Filter by state: {open|closed|merged|all}

-t,  --template <string>

Format JSON output using a Go template

-w,  --web

Open the browser to list the pull requests

Options Inherited from Parent Commands

-R,  --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format


List PRs authored by you
$ gh pr list --author "@me"

List PRs assigned to you
$ gh pr list --assignee "@me"

List PRs by label, combining multiple labels with AND
$ gh pr list --label bug --label "priority 1"

List PRs using search syntax
$ gh pr list --search "status:success review:required"

Open the list of PRs in a web browser
$ gh pr list --web

See Also


Referenced By


Jan 2022 GitHub CLI manual