gh-issue

manage repository issues and bug reports

TLDR

List issues
$ gh issue list
Create an issue
$ gh issue create
View an issue
$ gh issue view [number]
Close an issue
$ gh issue close [number]
Reopen an issue
$ gh issue reopen [number]
Edit an issue
$ gh issue edit [number]
Search issues
$ gh issue list --search "[query]"
List your issues
$ gh issue list --assignee @me

SYNOPSIS

gh issue command [options]

DESCRIPTION

gh issue manages GitHub issues for tracking bugs, feature requests, tasks, and discussions. Issues form the core of project management on GitHub, supporting labels, assignees, milestones, and projects.The command provides comprehensive issue lifecycle management including creation, editing, commenting, status changes, and deletion. Filtering capabilities enable finding issues by assignee, label, state, and search queries. Issues can be managed across multiple repositories.Integration with pull requests allows linking issues to code changes, with automatic closing when PRs merge using keywords in commit messages.

PARAMETERS

-R, --repo owner/repo

Repository.
-a, --assignee user
Filter by assignee.
-l, --label label
Filter by label.
-s, --state state
Filter by state.

SUBCOMMANDS

list

List issues.
create
Create an issue.
view
View an issue.
close
Close an issue.
reopen
Reopen an issue.
edit
Edit an issue.
comment
Add comment.
delete
Delete an issue.
status
Show status.

INSTALL

sudo apt install gh
sudo dnf install gh
sudo pacman -S github-cli
sudo apk add github-cli
sudo zypper install gh
brew install gh
nix profile install nixpkgs#gh

SEE ALSO

gh(1), gh-pr(1)

RESOURCES

Documentation · Source code