gh issue create

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.

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 <file>
Template file 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 --project "Roadmap"
$ gh issue create --template "bug_report.md"

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$