NAME¶

gcli repos — Manage remote repositories on various git forges

SYNOPSIS¶

DESCRIPTION¶

gcli repos can be used to list, search or manage your own or an organisation's repositories on git(1) forges such as GitHub, Gitea and GitLab.

With no actions given, gcli repos will list repositories, either of the through -o specified owner or, if omitted, your own.

When search-terms... have been specified, repos are instead searched for. To restrict the search to a specific owner, use -o owner.

With both owner and repository specified the given actions... are executed on the specified 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), gcli(1), emacs(1)

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

The Gitea backend doesn't yet support searching repositories of a given user:

$ gcli repos -o herrhotzenplotz foobar

This will error out indicating that this is not supported by gcli.

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.