Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

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>

home | help