1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
.Dd @PACKAGE_DATE@
.Dt GCLI-REPOS 1
.Os @PACKAGE_STRING@
.Sh NAME
.Nm gcli repos
.Nd Manage remote repositories on various git forges
.Sh SYNOPSIS
.Nm
.Op Fl s
.Op Fl n Ar n
.Op Fl o Ar owner
.Nm
.Cm create
.Fl r Ar name
.Op Fl d Ar description
.Op Fl p
.Nm
.Op Fl o Ar owner Fl r Ar repo
.Ar actions...
.Sh DESCRIPTION
.Nm
can be used to list or manage your own or an organization's
repositories on
.Xr git 1
forges such as Github, Gitea and GitLab. With no actions given,
.Nm
will list repositories, either of the through
.Fl o
specified owner or, if omitted, your own. Otherwise the given actions
are executed on the specified or autodetected repository. See
.Sx ACTIONS .
.Sh OPTIONS
.Bl -tag -width indent
.It Fl s , -sorted
Reverse the output such that most recent items appear at the bottom.
.It Fl o , -owner Ar owner
Operate on the repository of the given owner. This option can only be
used in combination with
.Fl r .
.It Fl r , -repo Ar repo
Operate on the given repository. This option can only be used in
combination with
.Fl o
unless you are creating a repository.
.It Fl y , -yes
Do not ask for confirmation. Assume yes. Applies only to the
.Cm delete
action.
.It Fl n , -count Ar n
Fetch at least
.Ar n
repositories. Setting
.Ar 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.
.It Fl d , -description Ar description
Set the description of a repo to be created.
.It Fl p , -private
Create a private repo.
.El
.Sh ACTIONS
.Ar actions...
may be one or more of the following:
.Bl -tag -width "set-visibility level"
.It Cm delete Op Fl y
Delete the repository. You will be asked for confirmation unless you set
.Fl y .
.It Cm set-visibility Ar level
Change the visibility level of the repository.
.Ar level
may be one of:
.Bl -tag -width "private"
.It private
Make the repository private.
.It public
Make the repository public.
.El
.El
.Sh EXAMPLES
List your own repos:
.Bd -literal -offset indent
$ gcli repos
.Ed
.Pp
List neutaaaaan's repositories:
.Bd -literal -offset indent
$ gcli repos -o neutaaaaan
.Ed
.Pp
Delete vim/vim without confirmation:
.Bd -literal -offset indent
$ gcli repos -o vim -r vim -y delete
.Ed
.Pp
Create a repository called emacs with a description and make it
public:
.Bd -literal -offset indent
$ gcli repos create -r emacs -d "welcome to the holy church of emacs."
.Ed
.Sh SEE ALSO
.Xr git 1 ,
.Xr gcli 1 ,
.Xr emacs 1
.Sh AUTHORS
.An Nico Sonack aka. herrhotzenplotz Aq Mt nsonack@herrhotzenplotz.de
and contributors.
.Sh BUGS
Currently it is only possible to create repositories for authenticated
users thus it is impossible to create a repository in another
organization.
.Pp
Please report bugs via E-Mail to
.Mt @PACKAGE_BUGREPORT@ .
.Pp
Alternatively you can report them on any of the forges linked at
.Lk @PACKAGE_URL@ .
However, the preferred and quickest method is to use the mailing
list.
|
