GH-ISSUE-CREATE(1) GitHub CLI manual GH-ISSUE-CREATE(1)

gh-issue-create - Create a new issue

gh issue create [flags]

Create an issue on GitHub.

Adding an issue to projects requires authorization with the project scope. To authorize, run gh auth refresh -s project.

Assign people by their login. Use "@me" to self-assign.
Supply a body. Will prompt for one otherwise.
Read body text from file (use "-" to read from standard input)
Skip prompts and open the text editor to write the title and body in. The first line is the title and the remaining text is the body.
Add labels by name
Add the issue to a milestone by name
Add the issue to projects by title
Recover input from a failed run of create
Template name to use as starting body text
Supply a title. Will prompt for one otherwise.
Open the browser to create an issue

Select another repository using the [HOST/]OWNER/REPO format

gh issue new

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

$ gh issue create --title "I found a bug" --body "Nothing works"
$ gh issue create --label "bug,help wanted"
$ gh issue create --label bug --label "help wanted"
$ gh issue create --assignee monalisa,hubot
$ gh issue create --assignee "@me"
$ gh issue create --project "Roadmap"
$ gh issue create --template "Bug Report"

gh-issue(1)

Jul 2025