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

FreeBSD Manual Pages

  
 
  

home | help
GCLI-FORKS(1)		     General Commands Manual		   GCLI-FORKS(1)

NAME
     gcli forks -- Manage repository forks in git forges

SYNOPSIS
     gcli forks [forge-path] [-n n] [-y] [-s] [-o owner -r repo] actions...
     gcli forks [forge-path] create [-o owner -r repo] [-i target-owner]

DESCRIPTION
     Use  gcli forks  to  manage  forks  of other repositories in various git(1)
     forges such as GitHub, GitLab and Gitea.

OPTIONS
     -o, --owner owner
	     Operate on the repository of the given owner. This option can  only
	     be used in combination with -r.

     -r, --repo repo
	     Operate  on  the  given repository. This option can only be used in
	     combination with -o.

     -y, --yes
	     Do not ask for confirmation. Assume yes.

     -s, --sorted
	     Reverse the output such that most recent items appear at  the  bot-
	     tom.

     -i, --into target-owner
	     When  forking  a  repository,  this is the organisation or user the
	     repository is forked into.

     -n, --count n
	     Fetch at least n forks. Setting n to -1 will fetch all  forks.  De-
	     fault:  30.  Note that on repositories with many forks fetching all
	     forks can take a considerable amount of time and may result in rate
	     limiting by the respective API.

ACTIONS
     actions... may be one or more of the following:

     delete  Delete the fork. You will be asked for confirmation unless you  set
	     -y.

	     The following flags can be specified:

	     -r, --repo
		     See "OPTIONS"

	     -o, --owner
		     See "OPTIONS"

	     -y, --yes
		     Do  not  ask for confirmation before deleting the fork. See
		     "OPTIONS".

EXAMPLES
     Clone vim/vim and fork it into your account:

	   $ git clone git@github.com:vim/vim
	   $ cd vim
	   $ gcli forks create --into <myaccount>

     This will ask you if you want to add a remote to your fork. In case you ac-
     cept the offer, the origin remote will be renamed to  upstream  and  a  new
     origin  will  be  pointed	at your newly created fork. You may also want to
     setup a .gcli file at the same time:

	   $ printf -- "pr.upstream=vim/vim\npr.base=trunk\n" >> .gcli

     Delete your fork of the current repository without confirmation:

	   $ gcli forks -y delete

     List forks of herrhotzenplotz/gcli on GitHub using the  forge  path  short-
     hand:

	   $ gcli forks gh:herrhotzenplotz/gcli

SEE ALSO
     git(1), gcli(1)

AUTHORS
     Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contribu-
     tors.

BUGS
     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-FORKS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gcli-forks&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help