NAME

     gcli forks — Manage repository forks in git forges

SYNOPSIS

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

DESCRIPTION

     Use gcli 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 bottom.

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

     -n, --count n
             Fetch at least n forks. Setting n to -1 will fetch all forks. Default: 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 accept 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

SEE ALSO

     git(1), gcli(1)

AUTHORS

     Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors.

BUGS

     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.