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