1hub-pr(1) hub manual hub-pr(1)
2
3
4
6 hub-pr - Manage GitHub Pull Requests for the current repository.
7
9 hub pr list [-s STATE] [-h HEAD] [-b BASE] [-o SORT_KEY [-^]] [-f
10 FORMAT] [-L LIMIT]
11 hub pr checkout PR-NUMBER [BRANCH]
12 hub pr show [-uc] [-f FORMAT] [-h HEAD]
13 hub pr show [-uc] [-f FORMAT] PR-NUMBER
14
16 list
17 List pull requests in the current repository.
18
19 checkout
20 Check out the head of a pull request in a new branch.
21
22 To update the pull request with new commits, use git push.
23
24 show
25 Open a pull request page in a web browser. When no PR-NUMBER is
26 specified, HEAD is used to look up open pull requests and defaults
27 to the current branch name. With --format, print information about
28 the pull request instead of opening it.
29
31 -s, --state STATE
32 Filter pull requests by STATE. Supported values are: "open"
33 (default), "closed", "merged", or "all".
34
35 -h, --head BRANCH
36 Show pull requests started from the specified head BRANCH. The
37 "OWNER:BRANCH" format must be used for pull requests from forks.
38
39 -b, --base BRANCH
40 Show pull requests based off the specified BRANCH.
41
42 -f, --format FORMAT
43 Pretty print the list of pull requests using format FORMAT
44 (default: "%pC%>(8)%i%Creset %t% l%n"). See the "PRETTY FORMATS"
45 section of git-log(1) for some additional details on how
46 placeholders are used in format. The available placeholders are:
47
48 %I: pull request number
49
50 %i: pull request number prefixed with "#"
51
52 %U: the URL of this pull request
53
54 %S: state ("open" or "closed")
55
56 %pS: pull request state ("open", "draft", "merged", or "closed")
57
58 %sC: set color to red or green, depending on state
59
60 %pC: set color according to pull request state
61
62 %t: title
63
64 %l: colored labels
65
66 %L: raw, comma-separated labels
67
68 %b: body
69
70 %B: base branch
71
72 %sB: base commit SHA
73
74 %H: head branch
75
76 %sH: head commit SHA
77
78 %sm: merge commit SHA
79
80 %au: login name of author
81
82 %as: comma-separated list of assignees
83
84 %rs: comma-separated list of requested reviewers
85
86 %Mn: milestone number
87
88 %Mt: milestone title
89
90 %cD: created date-only (no time of day)
91
92 %cr: created date, relative
93
94 %ct: created date, UNIX timestamp
95
96 %cI: created date, ISO 8601 format
97
98 %uD: updated date-only (no time of day)
99
100 %ur: updated date, relative
101
102 %ut: updated date, UNIX timestamp
103
104 %uI: updated date, ISO 8601 format
105
106 %mD: merged date-only (no time of day)
107
108 %mr: merged date, relative
109
110 %mt: merged date, UNIX timestamp
111
112 %mI: merged date, ISO 8601 format
113
114 %n: newline
115
116 %%: a literal %
117
118 --color[=WHEN]
119 Enable colored output even if stdout is not a terminal. WHEN can be
120 one of "always" (default for --color), "never", or "auto"
121 (default).
122
123 -o, --sort KEY
124 Sort displayed pull requests by "created" (default), "updated",
125 "popularity", or "long-running".
126
127 -^, --sort-ascending
128 Sort by ascending dates instead of descending.
129
130 -L, --limit LIMIT
131 Display only the first LIMIT pull requests.
132
133 -u, --url
134 Print the pull request URL instead of opening it.
135
136 -c, --copy
137 Put the pull request URL to clipboard instead of opening it.
138
140 hub-issue(1), hub-pull-request(1), hub(1)
141
142
143
144
145hub version 2.14.2 21 Jul 2022 hub-pr(1)