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 labels [--color]
15

COMMANDS

17       With no arguments, show a list of open issues.
18
19       show
20           Show an existing issue specified by NUMBER.
21
22       create
23           Open an issue in the current repository.
24
25       labels
26           List the labels available in this repository.
27

OPTIONS

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

SEE ALSO

167       hub-pr(1), hub(1)
168
169
170
171
172hub version 2.12.8                03 Oct 2019                     hub-issue(1)