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
21       ⟨https://docs.github.com/en/search-github/searching-on-github/search‐
22       ing-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                                   Nov 2023                      GH-PR-LIST(1)
Impressum