FreeBSD Manual Pages
GCLI-LABELS(1) General Commands Manual GCLI-LABELS(1) NAME gcli labels -- Manage ticket labels in git forges SYNOPSIS gcli labels [forge-path] [-o owner -r repo] gcli labels [forge-path] create [-o owner -r repo] -d description -n name -c colour gcli labels [-o owner -r repo] -i name actions... DESCRIPTION Use gcli labels to list, create, edit or delete labels for Pull Re- quests/Merge Requests and issues in repositories in various git forges such as GitHub, GitLab and Gitea. Without any action specified, gcli labels will list all defined labels in the given or auto-detected 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 com- bination with -o. -i, --name name Execute actions on the label identified by name. SUBCOMMANDS create Create a new label in the given or auto-detected 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 ex- pected to be a 6 digit hexadecimal RGB colour code. ACTIONS When given a specific label with -i you can execute one or more of the fol- lowing actions: status Print a short summary about the label. name new-name Change the name of the to the given new-name. description new-description Change the description of the label to new-description. You should wrap the description in quotes in case it contains spaces. colour hexcolour Change the colour of the label to the six-digit hexadecmial RGB colour code hexcolour. delete Delete the given label. 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 -o herrhotzenplotz -r gcli -i foobar delete List labels in herrhotzenplotz/gcli on GitLab using the forge path short- hand: $ gcli labels gl:herrhotzenplotz/gcli SEE ALSO git(1), gcli(1) AUTHORS Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contribu- tors. BUGS The delete subcommand should ask for confirmation and have a flag to over- ride this behaviour. Please report bugs via E-Mail to https://lists.sr.ht/~herrhotzenplotz/gcli- discuss. Alternatively you can report them on any of the forges linked at https://sr.ht/~herrhotzenplotz/gcli. However, the preferred and quickest method is to use the mailing list. gcli 2.12.0 30-May-2026 GCLI-LABELS(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SUBCOMMANDS | ACTIONS | EXAMPLES | SEE ALSO | AUTHORS | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gcli-labels&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>
