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

NAME

6       hub-issue - Manage GitHub Issues for the current repository.
7

SYNOPSIS

9       hub issue [-a ASSIGNEE] [-c CREATOR] [-@ USER] [-s STATE] [-f FORMAT]
10       [-M MILESTONE] [-l LABELS] [-d DATE] [-o SORT_KEY [-^]] [-L LIMIT]
11       hub issue show [-f FORMAT] NUMBER
12       hub issue create [-oc] [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M
13       MILESTONE] [-l LABELS]
14       hub issue update NUMBER [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M
15       MILESTONE] [-l LABELS] [-s STATE]
16       hub issue labels [--color]
17       hub issue transfer NUMBER REPO
18

COMMANDS

20       With no arguments, show a list of open issues.
21
22       show
23           Show an existing issue specified by NUMBER.
24
25       create
26           Open an issue in the current repository.
27
28       update
29           Update fields of an existing issue specified by NUMBER. Use --edit
30           to edit the title and message interactively in the text editor.
31
32       labels
33           List the labels available in this repository.
34
35       transfer
36           Transfer an issue to another repository.
37

OPTIONS

39       -a, --assignee ASSIGNEE
40           In list mode, display only issues assigned to ASSIGNEE.
41
42       -a, --assign USERS
43           A comma-separated list of GitHub handles to assign to the created
44           issue.
45
46       -c, --creator CREATOR
47           Display only issues created by CREATOR.
48
49       -@, --mentioned USER
50           Display only issues mentioning USER.
51
52       -s, --state STATE
53           Display issues with state STATE (default: "open").
54
55       -f, --format FORMAT
56           Pretty print the contents of the issues using format FORMAT
57           (default: "%sC%>(8)%i%Creset  %t%  l%n"). See the "PRETTY FORMATS"
58           section of git-log(1) for some additional details on how
59           placeholders are used in format. The available placeholders for
60           issues are:
61
62           %I: issue number
63
64           %i: issue number prefixed with "#"
65
66           %U: the URL of this issue
67
68           %S: state (i.e. "open", "closed")
69
70           %sC: set color to red or green, depending on issue state.
71
72           %t: title
73
74           %l: colored labels
75
76           %L: raw, comma-separated labels
77
78           %b: body
79
80           %au: login name of author
81
82           %as: comma-separated list of assignees
83
84           %Mn: milestone number
85
86           %Mt: milestone title
87
88           %NC: number of comments
89
90           %Nc: number of comments wrapped in parentheses, or blank string if
91           zero.
92
93           %cD: created date-only (no time of day)
94
95           %cr: created date, relative
96
97           %ct: created date, UNIX timestamp
98
99           %cI: created date, ISO 8601 format
100
101           %uD: updated date-only (no time of day)
102
103           %ur: updated date, relative
104
105           %ut: updated date, UNIX timestamp
106
107           %uI: updated date, ISO 8601 format
108
109           %n: newline
110
111           %%: a literal %
112
113       --color[=WHEN]
114           Enable colored output even if stdout is not a terminal. WHEN can be
115           one of "always" (default for --color), "never", or "auto"
116           (default).
117
118       -m, --message MESSAGE
119           The text up to the first blank line in MESSAGE is treated as the
120           issue title, and the rest is used as issue description in Markdown
121           format.
122
123           When multiple --message are passed, their values are concatenated
124           with a blank line in-between.
125
126           When neither --message nor --file were supplied to issue create, a
127           text editor will open to author the title and description in.
128
129       -F, --file FILE
130           Read the issue title and description from FILE. Pass "-" to read
131           from standard input instead. See --message for the formatting
132           rules.
133
134       -e, --edit
135           Open the issue title and description in a text editor before
136           submitting.  This can be used in combination with --message or
137           --file.
138
139       -o, --browse
140           Open the new issue in a web browser.
141
142       -c, --copy
143           Put the URL of the new issue to clipboard instead of printing it.
144
145       -M, --milestone NAME
146           Display only issues for a GitHub milestone with the name NAME.
147
148           When opening an issue, add this issue to a GitHub milestone with
149           the name NAME.  Passing the milestone number is deprecated.
150
151       -l, --labels LABELS
152           Display only issues with certain labels.
153
154           When opening an issue, add a comma-separated list of labels to this
155           issue.
156
157       -d, --since DATE
158           Display only issues updated on or after DATE in ISO 8601 format.
159
160       -o, --sort KEY
161           Sort displayed issues by "created" (default), "updated" or
162           "comments".
163
164       -^ --sort-ascending
165           Sort by ascending dates instead of descending.
166
167       -L, --limit LIMIT
168           Display only the first LIMIT issues.
169
170       --include-pulls
171           Include pull requests as well as issues.
172
173       --color
174           Enable colored output for labels list.
175

SEE ALSO

177       hub-pr(1), hub(1)
178
179
180
181
182hub version 2.14.2                20 Jul 2023                     hub-issue(1)