gh-label-list - Man Page
List labels in a repository
Synopsis
gh label list [flags]
Description
Display labels in a GitHub repository.
When using the --search flag results are sorted by best match of the query. This behavior cannot be configured with the --order or --sort flags.
Options
- -q, --jq <expression>
Filter JSON output using a jq expression
- --json <fields>
Output JSON with the specified fields
- -L, --limit <int> (default 30)
Maximum number of labels to fetch
- --order <string> (default "asc")
Order of labels returned: {asc|desc}
- -S, --search <string>
Search label names and descriptions
- --sort <string> (default "created")
Sort fetched labels: {created|name}
- -t, --template <string>
Format JSON output using a Go template; see "gh help formatting"
- -w, ā--web
List labels in the web browser
Options Inherited from Parent Commands
- -R, --repo <[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format
Aliases
gh label ls
JSON Fields
color, createdAt, description, id, isDefault, name, updatedAt, url
Exit Codes
0: Successful execution
1: Error
2: Command canceled
4: Authentication required
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.
Example
# sort labels by name $ gh label list --sort name # find labels with "bug" in the name or description $ gh label list --search bug