GitHub CLI

Issues Commands

Track and manage issues from the command line. Learn to create, update, search, and close issues with labels, assignees, and milestones.

9 commands

Pro Tips

Use 'gh issue list -l bug -s open' to filter issues by label and state.

Create issues from templates with 'gh issue create --template bug_report.md'.

Link PRs to issues: including 'Fixes #123' in PR description auto-closes the issue on merge.

Common Mistakes

Closing an issue doesn't delete it. Use issue locking for spam or resolved disputes.

Commands

Close issue

$ gh issue close <number>

Close an issue

Comment on issue

$ gh issue comment <number> --body "<comment>"

Add a comment to an issue

Create issue

$ gh issue create

Create a new issue interactively

Create issue with title

$ gh issue create --title "<title>" --body "<body>"

Create issue with specified title and body

Edit issue

$ gh issue edit <number> --title "<new-title>"

Edit an existing issue

List issues

$ gh issue list

List open issues in repository

List my issues

$ gh issue list --assignee @me

List issues assigned to you

Reopen issue

$ gh issue reopen <number>

Reopen a closed issue

View issue

$ gh issue view <number>

View issue details