1GH-PR-LIST(1)                  GitHub CLI manual                 GH-PR-LIST(1)
2
3
4

NAME

6       gh-pr-list - List pull requests in a repository
7
8
9

SYNOPSIS

11       gh pr list [flags]
12
13
14

DESCRIPTION

16       List pull requests in a GitHub repository.
17
18
19       The      search      query      syntax      is     documented     here:
20       https://docs.github.com/en/search-github/searching-on-github/searching-
21       issues-and-pull-requests            ⟨https://docs.github.com/en/search-
22       github/searching-on-github/searching-issues-and-pull-requests⟩
23
24
25

OPTIONS

27       --app <string>
28              Filter by GitHub App author
29
30
31       -a, --assignee <string>
32              Filter by assignee
33
34
35       -A, --author <string>
36              Filter by author
37
38
39       -B, --base <string>
40              Filter by base branch
41
42
43       -d, --draft
44              Filter by draft state
45
46
47       -H, --head <string>
48              Filter by head branch
49
50
51       -q, --jq <expression>
52              Filter JSON output using a jq expression
53
54
55       --json <fields>
56              Output JSON with the specified fields
57
58
59       -l, --label <strings>
60              Filter by label
61
62
63       -L, --limit <int>
64              Maximum number of items to fetch
65
66
67       -S, --search <query>
68              Search pull requests with query
69
70
71       -s, --state <string>
72              Filter by state: {open|closed|merged|all}
73
74
75       -t, --template <string>
76              Format JSON output using a Go template; see "gh help formatting"
77
78
79       -w, --web
80              List pull requests in the web browser
81
82
83

OPTIONS INHERITED FROM PARENT COMMANDS

85       -R, --repo <[HOST/]OWNER/REPO>
86              Select another repository using the [HOST/]OWNER/REPO format
87
88
89

EXAMPLE

91              List PRs authored by you
92              $ gh pr list --author "@me"
93
94              List only PRs with all of the given labels
95              $ gh pr list --label bug --label "priority 1"
96
97              Filter PRs using search syntax
98              $ gh pr list --search "status:success review:required"
99
100              Find a PR that introduced a given commit
101              $ gh pr list --search "<SHA>" --state merged
102
103
104
105
106

SEE ALSO

108       gh-pr(1)
109
110
111
112                                   Jan 2023                      GH-PR-LIST(1)
Impressum