gh-issue-create - Man Page
Create a new issue
Examples (TL;DR)
- Create a new issue against the current repository interactively:
gh issue create
- Create a new issue with the
bug
label interactively:gh issue create --label "bug"
- Create a new issue interactively and assign it to the specified users:
gh issue create --assignee user1,user2,...
- Create a new issue with a title, body and assign it to the current user:
gh issue create --title "title" --body "body" --assignee "@me"
- Create a new issue interactively, reading the body text from a file:
gh issue create --body-file path/to/file
- Create a new issue in the default web browser:
gh issue create --web
- Display the help:
gh issue create --help
Synopsis
gh issue create [flags]
Description
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)
- -l, --label <name>
Add labels by name
- -m, --milestone <name>
Add the issue to a milestone by name
- -p, --project <name>
Add the issue to projects by name
- --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
Example
$ 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"
See Also
Referenced By
Jul 2024 GitHub CLI manual