---
name: "gt-team-list"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-team-list"
---

# gt-team-list(1)

List organization teams

## NAME

gt-team-list - List organization teams

## SYNOPSIS

**gt team list \<org\> \[flags\]**

## 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.

### JSON FIELDS

```
access, all_repositories, can_create_repo, description, id, name,
organization, permission, units
```

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for list

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

**--page**=1\
 	Result page

## OPTIONS INHERITED FROM PARENT COMMANDS

**--csv**\[=""\]\
 	Output CSV with the specified comma-separated **fields**, or all fields

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

**--host**=""\
 	Gitea instance **URL**, including any base path

**--interactive**\[=false\]\
 	Allow prompts with machine output

**-q**, **--jq**=""\
 	Filter JSON output using a jq **expression**; implies --json

**--json**\[=""\]\
 	Output JSON with the specified comma-separated **fields**, or all fields

**--no-input**\[=false\]\
 	Disable prompts and implicit editor/browser interactions

**--sudo**=""\
 	Perform API requests as this **user** (requires an administrator account)

**--user**=""\
 	Account **name** on the selected instance

## EXAMPLE

```
$ gt team list acme
# print the team names
$ gt team list acme --jq '.[].name'
```

## SEE ALSO

**[gt-team(1)](/man/gt-team/1.md)**