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

# gcli-repos(1)

Manage remote repositories on various git forges

## NAME

**gcli** **repos** – Manage remote repositories on various git forges

## SYNOPSIS

**gcli** \[**-s**\] \[**-n** *n*\] \[**-o** *owner*\]

**gcli** **create** **-r** *name* \[**-d** *description*\] \[**-p**\]

**gcli** \[**-o** *owner* **-r** *repo*\] *actions...*

## DESCRIPTION

**gcli** can be used to list or manage your own or an organization's repositories on [git(1)](/git/1.md) forges such as Github, Gitea and GitLab. With no actions given, **gcli** will list repositories, either of the through **-o** specified owner or, if omitted, your own. Otherwise the given actions are executed on the specified or autodetected repository. See ACTIONS.

## OPTIONS

- **-s**, **--sorted**

  Reverse the output such that most recent items appear at the bottom.

- **-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** unless you are creating a repository.

- **-y**, **--yes**

  Do not ask for confirmation. Assume yes. Applies only to the **delete** action.

- **-n**, **--count** *n*

  Fetch at least *n* repositories. Setting *n* to -1 will fetch all repositories. Default: 30. Note that on owners with many repositories fetching all of them can take a considerable amount of time and may result in rate limiting by the GitHub/GitLab API.

- **-d**, **--description** *description*

  Set the description of a repo to be created.

- **-p**, **--private**

  Create a private repo.

## ACTIONS

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

- **delete** \[**-y**\]

  Delete the repository. You will be asked for confirmation unless you set **-y**.

- **set-visibility** *level*

  Change the visibility level of the repository. *level* may be one of:

  - private

    Make the repository private.

  - public

    Make the repository public.

## EXAMPLES

List your own repos:

```
$ gcli repos
```

List neutaaaaan's repositories:

```
$ gcli repos -o neutaaaaan
```

Delete vim/vim without confirmation:

```
$ gcli repos -o vim -r vim -y delete
```

Create a repository called emacs with a description and make it public:

```
$ gcli repos create -r emacs -d "welcome to the holy church of emacs."
```

## SEE ALSO

[git(1)](/git/1.md), [gcli(1)](/gcli/1.md), [emacs(1)](/emacs/1.md)

## AUTHORS

Nico Sonack aka. herrhotzenplotz ⟨*nsonack@herrhotzenplotz.de*⟩ and contributors.

## BUGS

Currently it is only possible to create repositories for authenticated users thus it is impossible to create a repository in another organization.

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.