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

OPTIONS

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

SEE ALSO

140       hub-issue(1), hub-pull-request(1), hub(1)
141
142
143
144
145hub version 2.14.2                20 Jul 2023                        hub-pr(1)
Impressum