---
name: "gcli-forks"
section: "1"
platform: "linux"
package: "gcli"
version: "2.3.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gcli-forks"
---

# gcli-forks(1)

Manage repository forks in git forges

## 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)](/git/1.md) 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)](/git/1.md), [gcli(1)](/gcli/1.md)

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