---
name: "gcli-labels"
section: "1"
platform: "linux"
package: "gcli"
version: "2.3.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gcli-labels"
---

# gcli-labels(1)

Manage ticket labels in git forges

## NAME

**gcli** **labels** – Manage ticket labels in git forges

## SYNOPSIS

**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*

## DESCRIPTION

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
```

## SEE ALSO

[git(1)](/git/1.md), [gcli(1)](/gcli/1.md)

## AUTHORS

Nico Sonack aka. herrhotzenplotz ⟨*nsonack@herrhotzenplotz.de*⟩ and contributors.

## BUGS

The delete subcommand should ask for confirmation and have a flag to override this behaviour.

Please report bugs via E-Mail to *~herrhotzenplotz/gcli-discuss@lists.sr.ht*.

Alternatively you can report them on any of the forges linked at **https://herrhotzenplotz.de/gcli**. However, the preferred and quickest method is to use the mailing list.