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

gcli 2.2.0                                         2024-Feb-05                                     GCLI-REPOS(1)