LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

hub-issue

manages GitHub issues from the command line

TLDR

List open issues
$ hub issue
copy
List issues with a label
$ hub issue -l [bug]
copy
Create a new issue (opens an editor)
$ hub issue create
copy
Create with title and body
$ hub issue create -m "[title]" -m "[body]"
copy
Show a specific issue
$ hub issue show [123]
copy
List an assignee's issues
$ hub issue -a [username]
copy

SYNOPSIS

hub issue [-a assignee] [-c creator] [-@ user] [-s state] [-f format] [-M milestone] [-l labels] [-L limit]hub issue show [-f format] numberhub issue create [-o] [-m message | -F file] [--edit] [-a users] [-M milestone] [-l labels]hub issue transfer number repository

DESCRIPTION

hub issue manages GitHub issues from the command line. List, create, update, and view issues without leaving the terminal.With no arguments, it lists open issues for the current repository, sorted by creation date. Subcommands cover viewing a single issue, filing new ones, editing existing ones, listing labels, and transferring an issue to another repository.

PARAMETERS

-a, --assignee user

In list mode, show only issues assigned to user. In create/update mode (--assign), a comma-separated list of users to assign.
-c, --creator user
Show only issues created by user.
-@, --mentioned user
Show only issues mentioning user.
-s, --state state
Show issues with state open, closed, or all (default: open).
-f, --format format
Customize output using placeholders such as %i (number), %t (title), %S (state), %l (labels), %b (body), %au (author).
-M, --milestone name
Show only issues for the given milestone.
-l, --labels labels
Show only issues with the given comma-separated labels.
-d, --since date
Show only issues updated on or after date (ISO 8601).
-L, --limit n
Show only the first n issues.
-m, --message msg
Issue title/body text (repeatable; first line is the title).
-F, --file file
Read the issue title and description from file.
--edit
Open the title and description in a text editor before submitting.
-o, --browse
Open the new issue in a web browser instead of printing its URL.
--include-pulls
Include pull requests alongside issues.

SUBCOMMANDS

list

List issues in the current repository (default when no subcommand is given).
show number
Show an existing issue.
create
Open a new issue in the current repository.
update number
Update fields of an existing issue.
labels
List the labels available in this repository.
transfer number repository
Transfer an issue to another repository.

INSTALL

sudo apt install hub
copy
sudo pacman -S hub
copy
sudo zypper install hub
copy
brew install hub
copy
nix profile install nixpkgs#hub
copy

CAVEATS

Part of hub, which is deprecated in favor of the official GitHub CLI (gh); consider using gh issue instead. Requires GitHub authentication.

SEE ALSO

hub(1), gh-issue(1)

RESOURCES

Copied to clipboard
Kai