docs(teams): add CHANGELOG entry, README examples, regenerate CLI reference

Document the new 'tea teams' family of subcommands in the CHANGELOG
under the Unreleased section, add usage examples to the README after
the existing webhooks examples, and regenerate docs/CLI.md.

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## Unreleased
+
+* FEATURES
+  * Add `tea teams` subcommand for managing organization teams (list, create, delete, edit)
+
 ## [v0.13.0](https://gitea.com/gitea/tea/releases/tag/v0.13.0) - 2026-04-05
 
 * FEATURES

README.md

@@ -45,6 +45,7 @@ COMMANDS:
     actions                           Manage repository actions (secrets, variables)
     comment, c                        Add a comment to an issue / pr
     webhooks, webhook                 Manage repository webhooks
+    teams, team                       Manage organization teams
 
   HELPERS:
     open, o                         Open something of the repository in web browser
@@ -88,6 +89,11 @@ EXAMPLES
   tea webhooks list --org myorg       # list organization webhooks
   tea webhooks create https://example.com/hook --events push,pull_request
 
+  tea teams list --org myorg          # list teams in an organization
+  tea teams create dev-team --org myorg --permission write --can-create-repo
+  tea teams edit 5 --no-create-repo   # flip a team's create-repo flag off
+  tea teams delete 5 -y               # delete team ID 5 without prompting
+
   # send gitea desktop notifications every 5 minutes (bash + libnotify)
   while :; do tea notifications --mine -o simple | xargs -i notify-send {}; sleep 300; done
 

docs/CLI.md

@@ -1945,6 +1945,100 @@ Update a webhook
 
 **--url**="": webhook URL
 
+## teams, team
+
+Manage organization teams
+
+**--login**="": gitea login instance to use
+
+**--org**="": organization to operate on
+
+**--output, -o**="": output format [table, csv, simple, tsv, yaml, json]
+
+### list, ls
+
+List teams in an organization
+
+**--limit, --lm**="": specify limit of items per page (default: 30)
+
+**--login, -l**="": Use a different Gitea Login. Optional
+
+**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)
+
+**--page, -p**="": specify page (default: 1)
+
+**--remote, -R**="": Discover Gitea login from remote. Optional
+
+**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
+
+**--search**="": filter teams by name (substring match)
+
+### create, add, c
+
+Create a new team
+
+**--all-repos**: grant access to all organization repositories
+
+**--can-create-repo**: allow team members to create repositories
+
+**--description**="": team description
+
+**--login, -l**="": Use a different Gitea Login. Optional
+
+**--org**="": organization to create the team in
+
+**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)
+
+**--permission**="": team permission level: read, write, admin (default: "read")
+
+**--remote, -R**="": Discover Gitea login from remote. Optional
+
+**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
+
+**--units**="": repository units the team can access (code, issues, pulls, wiki, releases, projects, packages, actions)
+
+### delete, rm, remove
+
+Delete a team
+
+**--confirm, -y**: confirm deletion without prompting
+
+**--login, -l**="": Use a different Gitea Login. Optional
+
+**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)
+
+**--remote, -R**="": Discover Gitea login from remote. Optional
+
+**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
+
+### edit, update
+
+Edit a team
+
+**--all-repos**: grant access to all organization repositories
+
+**--can-create-repo**: allow team members to create repositories
+
+**--description**="": new team description
+
+**--login, -l**="": Use a different Gitea Login. Optional
+
+**--name**="": new team name
+
+**--no-all-repos**: remove access to all organization repositories
+
+**--no-create-repo**: disallow team members to create repositories
+
+**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)
+
+**--permission**="": team permission level: read, write, admin
+
+**--remote, -R**="": Discover Gitea login from remote. Optional
+
+**--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
+
+**--units**="": repository units the team can access (code, issues, pulls, wiki, releases, projects, packages, actions)
+
 ## comments, comment, c
 
 Manage comments on issues and pull requests