gcli-labels(1)

Usage

gcli [-o owner -r repo]

gcli create [-o owner -r repo] -d description -n name -c colour

gcli delete [-o owner -r repo] name or id

Overview

Use gcli to list, create, edit or delete labels for Pull Requests/Merge Requests and issues in repositories in various git forges such as GitHub, GitLab and Gitea. Without any action specified, gcli will list all defined labels in the given or autodetected repository.

Options

-o, --owner owner: Work in the repository of the given owner. This option can only be used in combination with -r.
-r, --repo repo: Work in the given repository. This option can only be used in combination with -o.

Subcommands

create

Create a new label in the given or autodetected repository.

The following flags must be specified:

-n, --name name: Set the short name of the label to the given name.
-d, --description description: Set the description of the label to the given text. Note that on GitHub this field may only consist of up to 150 characters.
-c, --colour code: Set the colour of the label to the given code. code is expected to be a 6 digit hexadecimal RGB colour code.

delete

Delete the specified label in the given or autodetected repository.

There are no flags for this subcommand.

Examples

Print a list of all labels in the current project:

$ gcli labels

Create a new label called ‘bug’ with a description ‘Something is not working as expected’ and give it a red colour:

$ gcli labels create \
		--name bug \
		--description "Something is not working as expected" \
		--colour FF0000

Delete the label ‘foobar’ in herrhotzenplotz/gcli and use the configured account ‘gitlab’:

$ gcli -a gitlab labels delete -o herrhotzenplotz -r gcli foobar

Referred to by