.nh
.TH "GT-TEAM-LIST" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-team-list - List organization teams


.SH SYNOPSIS
\fBgt team list <org> [flags]\fP


.SH DESCRIPTION
List the teams of an organization with their access to its repositories and, when the page
holds at most 10 teams, their member and repository counts. Gitea reports no counts with the
teams, so each team costs two more requests; gt team view shows the counts of one team.

.SS JSON FIELDS
.EX
access, all_repositories, can_create_repo, description, id, name,
organization, permission, units
.EE


.SH OPTIONS
\fB-h\fP, \fB--help\fP[=false]
	help for list

.PP
\fB-L\fP, \fB--limit\fP=30
	Maximum number of results (1..1000)

.PP
\fB--page\fP=1
	Result page


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--csv\fP[=""]
	Output CSV with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--debug\fP[=false]
	Log the method, URL, status, and duration of each HTTP request to stderr

.PP
\fB--host\fP=""
	Gitea instance \fBURL\fR, including any base path

.PP
\fB--interactive\fP[=false]
	Allow prompts with machine output

.PP
\fB-q\fP, \fB--jq\fP=""
	Filter JSON output using a jq \fBexpression\fR; implies --json

.PP
\fB--json\fP[=""]
	Output JSON with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--no-input\fP[=false]
	Disable prompts and implicit editor/browser interactions

.PP
\fB--sudo\fP=""
	Perform API requests as this \fBuser\fR (requires an administrator account)

.PP
\fB--template\fP=""
	Format JSON output using a Go \fBtemplate\fR; implies --json (see gt help formatting)

.PP
\fB--user\fP=""
	Account \fBname\fR on the selected instance


.SH EXAMPLE
.EX
$ gt team list acme
# print the team names
$ gt team list acme --jq '.[].name'
.EE


.SH SEE ALSO
\fBgt-team(1)\fP