NAME¶

glab-work-items-create - Create work items in a project or group. (EXPERIMENTAL)

SYNOPSIS¶

glab work-items create [flags]

DESCRIPTION¶

Use --type to specify the kind of work item to create. The command uses your repository context to detect scope automatically.

--attach uploads a file and references it at the end of the description. Repeat the flag for more than one file, or pass - to read the file from standard input. Uploads are project-scoped, so --attach cannot be combined with --group.

This feature is an experiment and is not ready for production use. It might be unstable or removed at any time. For more information, see https://docs.gitlab.com/policy/development_stages_support/.

OPTIONS¶

--attach=[] (EXPERIMENTAL) Upload a file and reference it at the end of the description. Use "-" to read the file from standard input. Repeat the flag to attach multiple files.

-c, --confidential[=false] Mark work item confidential.

-d, --description="" Description of the work item. Set to "-" to open an editor.

--description-file="" Read the work item description from a file. Use "-" to read from standard input.

-g, --group="" Create work items for a group or subgroup.

--jq="" Filter JSON output with a jq expression.

-F, --output="text" Format output as: text, json.

-R, --repo="" Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

-t, --title="" Add a title for the work item.

-T, --type="" Type of work item (epic, incident, issue, key_result, objective, requirement, task, test_case, ticket).

OPTIONS INHERITED FROM PARENT COMMANDS¶

-h, --help[=false] Show help for this command.

EXAMPLE¶

# Create a work item in the current project
glab work-items create --type issue
# Create a work item in a group
glab work-items create --type epic --group my-group
# Read the description from a file
glab work-items create --type issue --title "Add feature" --description-file description.md
# Read the description from standard input
cat description.md | glab work-items create --type issue --title "Add feature" --description-file -
# Attach a screenshot to the description
glab work-items create --type issue --title "Add feature" --attach ./screenshot.png

SEE ALSO¶

glab-work-items(1)