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           If multiple MESSAGE options are given, their values are
114           concatenated as separate paragraphs.
115
116       -F, --file FILE
117           Read the issue title and description from FILE.
118
119       -e, --edit
120           Further edit the contents of FILE in a text editor before
121           submitting.
122
123       -o, --browse
124           Open the new issue in a web browser.
125
126       -c, --copy
127           Put the URL of the new issue to clipboard instead of printing it.
128
129       -M, --milestone ID
130           Display only issues for a GitHub milestone with id ID.
131
132           When opening an issue, add this issue to a GitHub milestone with id
133           ID.
134
135       -l, --labels LABELS
136           Display only issues with certain labels.
137
138           When opening an issue, add a comma-separated list of labels to this
139           issue.
140
141       -d, --since DATE
142           Display only issues updated on or after DATE in ISO 8601 format.
143
144       -o, --sort KEY
145           Sort displayed issues by "created" (default), "updated" or
146           "comments".
147
148       -^ --sort-ascending
149           Sort by ascending dates instead of descending.
150
151       -L, --limit LIMIT
152           Display only the first LIMIT issues.
153
154       --include-pulls
155           Include pull requests as well as issues.
156
157       --color
158           Enable colored output for labels list.
159

SEE ALSO

161       hub-pr(1), hub(1)
162
163
164
165
166hub version 2.11.2                22 Apr 2019                     hub-issue(1)
Impressum