Scroll to navigation

HUB-ISSUE(1) Hub Manual HUB-ISSUE(1)


hub-issue - Manage GitHub issues for the current project.


hub issue [-a ASSIGNEE] [-c CREATOR] [-@ USER] [-s STATE] [-f FORMAT] [-M MILESTONE] [-l LABELS] [-d DATE] [-o SORT_KEY [-^]] [-L LIMIT]
hub issue show [-f FORMAT] NUMBER
hub issue create [-oc] [-m MESSAGE|-F FILE] [--edit] [-a USERS] [-M MILESTONE] [-l LABELS]
hub issue labels [--color]


With no arguments, show a list of open issues.
Show an existing issue specified by NUMBER.
Open an issue in the current project.
List the labels available in this repository.


-a, --assignee=ASSIGNEE
Display only issues assigned to ASSIGNEE.
When opening an issue, this can be a comma-separated list of people to assign to the new issue.
-c, --creator=CREATOR
Display only issues created by CREATOR.
-@, --mentioned=USER
Display only issues mentioning USER.
-s, --state=STATE
Display issues with state STATE (default: "open").
-f, --format=FORMAT
Pretty print the contents of the issues using format FORMAT (default: "%sC%>(8)%i%Creset %t% l%n"). See the "PRETTY FORMATS" section of git-log(1) for some additional details on how placeholders are used in format. The available placeholders for issues are:
%I: issue number
%i: issue number prefixed with "#"
%U: the URL of this issue
%S: state (i.e. "open", "closed")
%sC: set color to red or green, depending on issue state.
%t: title
%l: colored labels
%L: raw, comma-separated labels
%b: body
%au: login name of author
%as: comma-separated list of assignees
%Mn: milestone number
%Mt: milestone title
%NC: number of comments
%Nc: number of comments wrapped in parentheses, or blank string if zero.
%cD: created date-only (no time of day)
%cr: created date, relative
%ct: created date, UNIX timestamp
%cI: created date, ISO 8601 format
%uD: updated date-only (no time of day)
%ur: updated date, relative
%ut: updated date, UNIX timestamp
%uI: updated date, ISO 8601 format
%n: newline
%%: a literal %
-m, --message=MESSAGE
The text up to the first blank line in MESSAGE is treated as the issue title, and the rest is used as issue description in Markdown format.
If multiple MESSAGE options are given, their values are concatenated as separate paragraphs.
-F, --file=FILE
Read the issue title and description from FILE.
-e, --edit
Further edit the contents of FILE in a text editor before submitting.
-o, --browse
Open the new issue in a web browser.
-c, --copy
Put the URL of the new issue to clipboard instead of printing it.
-M, --milestone=ID
Display only issues for a GitHub milestone with id ID.
When opening an issue, add this issue to a GitHub milestone with id ID.
-l, --labels=LABELS
Display only issues with certain labels.
When opening an issue, add a comma-separated list of labels to this issue.
-d, --since=DATE
Display only issues updated on or after DATE in ISO 8601 format.
-o, --sort=SORT_KEY
Sort displayed issues by "created" (default), "updated" or "comments".
-^ --sort-ascending
Sort by ascending dates instead of descending.
-L, --limit=LIMIT
Display only the first LIMIT issues.
Include pull requests as well as issues.
Enable colored output for labels list.

March 2019 GITHUB