From 33466175816c1067c1e96bccbc0b9ec09971f3be Mon Sep 17 00:00:00 2001
From: Ross Golder <ross@golder.org>
Date: Thu, 30 Jul 2026 10:27:33 +0700
Subject: [PATCH] docs(teams-members): update CHANGELOG, README, regenerate CLI
 reference

Add a CHANGELOG entry for 'tea teams members', extend the README
examples with member-management lines, and regenerate docs/CLI.md.
---
 CHANGELOG.md |  1 +
 README.md    |  2 ++
 docs/CLI.md  | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 49 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8e43ffde..7e4e3a98 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
 ## Unreleased
 
 * FEATURES
+  * Add `tea teams members` subcommand for managing team membership (list, add, remove)
   * 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
diff --git a/README.md b/README.md
index 5c2d0e43..457d57ef 100644
--- a/README.md
+++ b/README.md
@@ -93,6 +93,8 @@ EXAMPLES
   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
+  tea teams members list 5            # list members of team ID 5
+  tea teams members add 5 alice -y    # add a user to a team
 
   # 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 34278335..96ae5ef5 100644
--- a/docs/CLI.md
+++ b/docs/CLI.md
@@ -2039,6 +2039,52 @@ Edit a team
 
 **--units**="": repository units the team can access (code, issues, pulls, wiki, releases, projects, packages, actions)
 
+### members, member
+
+Manage team members
+
+#### list, ls
+
+List team members
+
+**--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
+
+#### create, add, c
+
+Add a member to a team
+
+**--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
+
+#### delete, rm, remove
+
+Remove a member from a team
+
+**--confirm, -y**: confirm removal 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
+
 ## comments, comment, c
 
 Manage comments on issues and pull requests