gh issue create
Create an issue on GitHub.
Adding an issue to projects requires authorization with the project scope.
To authorize, run gh auth refresh -s project.
The --assignee flag supports the following special values:
- @me: assign yourself
- @copilot: assign Copilot (not supported on GitHub Enterprise Server)
Options
-a,
--assignee <login>
Assign people by their login. Use "@me" to self-assign.
-b,
--body <string>
Supply a body. Will prompt for one otherwise.
-F,
--body-file <file>
Read body text from file (use "-" to read from standard input)
-e,
--editor
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.
-l,
--label <name>
Add labels by name
-m,
--milestone <name>
Add the issue to a milestone by name
-p,
--project <title>
Add the issue to projects by title
--recover <string>
Recover input from a failed run of create
-T,
--template <name>
Template name to use as starting body text
-t,
--title <string>
Supply a title. Will prompt for one otherwise.
-w,
--web
Open the browser to create an issue
Options inherited from parent commands
-R,
--repo <[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format
ALIASES
gh issue new
Examples
$ 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
--assignee "@copilot"
$ gh issue create
--project "Roadmap"
$ gh issue create
--template "Bug Report"
See also
In use
Interactively
# Create an issue interactively
~/Projects/my-project$ gh issue create
Creating issue in owner/repo
? Title My new issue
? Body [(e) to launch nano, enter to skip]
http://github.com/owner/repo/issues/1
~/Projects/my-project$
With flags
# Create an issue using flags
~/Projects/my-project$ gh issue create --title "Issue title" --body "Issue body"
http://github.com/owner/repo/issues/1
~/Projects/my-project$
In the browser
// Quickly navigate to the issue creation page
~/Projects/my-project$ gh issue create --web
Opening https://github.com/owner/repo/issues/new in your browser.
~/Projects/my-project$