1hub-pr(1)                         hub manual                         hub-pr(1)
2
3
4

NAME

6       hub-pr - Manage GitHub Pull Requests for the current repository.
7

SYNOPSIS

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

COMMANDS

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       show
23           Open a pull request page in a web browser. When no PR-NUMBER is
24           specified, HEAD is used to look up open pull requests and defaults
25           to the current branch name. With --format, print information about
26           the pull request instead of opening it.
27

OPTIONS

29       -s, --state STATE
30           Filter pull requests by STATE. Supported values are: "open"
31           (default), "closed", "merged", or "all".
32
33       -h, --head BRANCH
34           Show pull requests started from the specified head BRANCH. The
35           "OWNER:BRANCH" format must be used for pull requests from forks.
36
37       -b, --base BRANCH
38           Show pull requests based off the specified BRANCH.
39
40       -f, --format FORMAT
41           Pretty print the list of pull requests using format FORMAT
42           (default: "%pC%>(8)%i%Creset  %t%  l%n"). See the "PRETTY FORMATS"
43           section of git-log(1) for some additional details on how
44           placeholders are used in format. The available placeholders are:
45
46           %I: pull request number
47
48           %i: pull request number prefixed with "#"
49
50           %U: the URL of this pull request
51
52           %S: state ("open" or "closed")
53
54           %pS: pull request state ("open", "draft", "merged", or "closed")
55
56           %sC: set color to red or green, depending on state
57
58           %pC: set color according to pull request state
59
60           %t: title
61
62           %l: colored labels
63
64           %L: raw, comma-separated labels
65
66           %b: body
67
68           %B: base branch
69
70           %sB: base commit SHA
71
72           %H: head branch
73
74           %sH: head commit SHA
75
76           %sm: merge commit SHA
77
78           %au: login name of author
79
80           %as: comma-separated list of assignees
81
82           %rs: comma-separated list of requested reviewers
83
84           %Mn: milestone number
85
86           %Mt: milestone title
87
88           %cD: created date-only (no time of day)
89
90           %cr: created date, relative
91
92           %ct: created date, UNIX timestamp
93
94           %cI: created date, ISO 8601 format
95
96           %uD: updated date-only (no time of day)
97
98           %ur: updated date, relative
99
100           %ut: updated date, UNIX timestamp
101
102           %uI: updated date, ISO 8601 format
103
104           %mD: merged date-only (no time of day)
105
106           %mr: merged date, relative
107
108           %mt: merged date, UNIX timestamp
109
110           %mI: merged date, ISO 8601 format
111
112           %n: newline
113
114           %%: a literal %
115
116       --color[=WHEN]
117           Enable colored output even if stdout is not a terminal. WHEN can be
118           one of "always" (default for --color), "never", or "auto"
119           (default).
120
121       -o, --sort KEY
122           Sort displayed pull requests by "created" (default), "updated",
123           "popularity", or "long-running".
124
125       -^, --sort-ascending
126           Sort by ascending dates instead of descending.
127
128       -L, --limit LIMIT
129           Display only the first LIMIT pull requests.
130
131       -u, --url
132           Print the pull request URL instead of opening it.
133
134       -c, --copy
135           Put the pull request URL to clipboard instead of opening it.
136

SEE ALSO

138       hub-issue(1), hub-pull-request(1), hub(1)
139
140
141
142
143hub version 2.14.0                29 Jan 2020                        hub-pr(1)
Impressum