From bcdd28f395b6acced60fdd28947c45381b1d9602 Mon Sep 17 00:00:00 2001
From: Ross Golder <ross@golder.org>
Date: Thu, 30 Jul 2026 10:26:41 +0700
Subject: [PATCH] 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 |  5 +++
 README.md    |  6 ++++
 docs/CLI.md  | 94 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 105 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5f4d1b70..8e43ffde 100644
--- a/CHANGELOG.md
+++ b/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
diff --git a/README.md b/README.md
index 2293b841..5c2d0e43 100644
--- a/README.md
+++ b/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
 
diff --git a/docs/CLI.md b/docs/CLI.md
index 2363574b..34278335 100644
--- a/docs/CLI.md
+++ b/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