create
The create command lets you create an issue or to add a comment to an existing issue.

Usage

1
kit issue create [options]
Copied!
1
Usage:
2
kit issue create [flags]
3
4
Flags:
5
-a, --assignees string Specify push key of assignees to add to the issue/comment (max. 10)
6
-b, --body string The body of the issue (max. 8 KB)
7
-c, --close Close the issue
8
--editor string Specify an editor to use instead of the git configured editor
9
-f, --force Forcefully create comment (uncommitted changes will be lost)
10
-h, --help help for create
11
-i, --id int Specify a target issue number
12
-l, --labels string Specify labels to add to the issue/comment (max. 10)
13
--new Force new issue to be created instead of adding a comment to HEAD
14
--no-body Skip prompt for issue body
15
-e, --reactions strings Add reactions to a reply (max. 10)
16
-o, --reopen Open a closed issue
17
-r, --reply string Specify the hash of a comment to respond to
18
-t, --title string The title of the issue (max. 250 B)
19
-u, --use-editor Use git's `core.editor` program to write the body
Copied!

Options

  • id - Provide the ID of the issue; Must be a number with not more than 16 characters in length. For example, if the ID is 10, then the issue reference will be refs/heads/issues/10. If an issue exists with the matching ID, a comment will be added to the existing issue.
  • -t, --title - The title of the issue. Required only when creating a new issue. If unset, a prompt will be started to ask for it.
  • -b, --body - The body of the issue or comment. If unset, a prompt will be started to ask for it.
  • -l, --labels - Add up to 10 labels to the issue.
  • -a, --assignees - Add up to 10 assignees to the issue.
  • -e, --reactions - Provide up to 10 reactions to a comment. Supports Unicode v13.0 emoji list. Note: emoji short names with spaces must replace them with underscore (_) character. For example, upside-down face becomes upside-down_face.
  • -r, --reply - Specify the hash of a comment in an existing issue you wish to respond to. If provided, reactions will be addressed to the target comment.
  • -c, --close - Close an issue. The user must have update rights to successfully push a closed issue reference.
  • -o, --reopen - Reopen a closed issue. The user must have update rights to successfully push the reopened issue reference.
  • --editor - Specify an editor program to use to write the body instead of a prompt or -b flag.
  • -u, --use-editor - Similar to --editor but uses default git editor set in core.editor.
  • --new - While checked into an issue branch, force the command to create a new issue instead of adding a comment to the checked-out issue. Note: If the checked out branch is dirty, it will fail without using --force to ignore unsaved changes.
  • --no-body - Prevent the command from starting a prompt to ask for the body.
  • --force - Ignore unsaved changes to the currently checked out branch. Unsaved updates will be lost.

Example

  • Create an issue using --title and --body flags.
Bash
Output
1
kit issue create \
2
--title="header not visible" \
3
--body="i am unable to see the header..."
Copied!
1
refs/heads/issues/1
Copied!
  • Create an issue with an explicitly provided issue ID.
1
kit issue create --id="123"
Copied!
  • Reply to a comment in an issue and add reactions.
1
kit issue create \
2
--id="123" \
3
--reply="63fbec94fe9a8d5aef4a26f4598449888511e033" \
4
--reactions="smile,star-struck" \
5
--title="header not visible" \
6
--body="i am unable to see the header..." \
Copied!
Last modified 11mo ago
Copy link