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.