- bookworm-backports 2.2.0-1~bpo12+1
- testing 2.2.0-1+b1
- unstable 2.3.0-1
GCLI-REPOS(1) | General Commands Manual | GCLI-REPOS(1) |
NAME¶
gcli repos
—
Manage remote repositories on various git forges
SYNOPSIS¶
gcli repos |
[-s ] [-n
n] [-o
owner] |
gcli repos |
create -r
name [-d
description] [-p ] |
gcli repos |
[-o owner
-r repo]
actions... |
DESCRIPTION¶
gcli repos
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 repos
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¶
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.
2024-May-25 | gcli 2.3.0 |