labels

name	labels
description	List, create, update, and delete Gitea/Forgejo issue labels.
user-invokable	true

Labels

List

tea labels list -o simple          # all labels, compact output (recommended)
tea labels list --output json      # use json only when parsing with jq
tea labels list --save             # export to file (tea internal format)

Create

tea labels create --name "bug" --color "#d73a4a"
tea labels create --name "enhancement" --color "#a2eeef" --description "New feature or request"
tea labels create --file labels.csv   # bulk import from file

Update

# Get label ID (requires json for parsing)
tea labels list --output json | jq '.[] | {id, name, color}'

tea labels update --id 5 --name "bugfix" --color "#d73a4a"
tea labels update --id 5 --description "Updated description"

Delete

tea labels delete 5

Apply to Issues

tea issues create --title "Fix login" --labels "type:bug,priority:high"
tea issues edit 42 --add-labels "status:in-progress"
tea issues edit 42 --remove-labels "status:needs-triage"

Tips

• Labels identified by name in tea issues, by ID in tea labels update/delete
• Colors need # prefix (e.g., #d73a4a)
• Names are case-sensitive
• Deleting a label removes it from all issues/PRs