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

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

List forks of herrhotzenplotz/gcli on GitHub using the forge path shorthand:

    $ gcli forks gh:herrhotzenplotz/gcli

SEE ALSO
git(1), gcli(1)

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

BUGS
Please report bugs via E-Mail to @PACKAGE_BUGREPORT@.

Alternatively you can report them on any of the forges linked at @PACKAGE_URL@. However, the preferred and quickest method is to use the mailing list.