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

Add a CHANGELOG entry for 'tea teams repos', extend the README
examples with repository-access 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 7e4e3a98..592c48f7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
 ## Unreleased
 
 * FEATURES
+  * Add `tea teams repos` subcommand for managing team repository access (list, add, remove)
   * Add `tea teams members` subcommand for managing team membership (list, add, remove)
   * Add `tea teams` subcommand for managing organization teams (list, create, delete, edit)
 
diff --git a/README.md b/README.md
index 457d57ef..b2af289f 100644
--- a/README.md
+++ b/README.md
@@ -95,6 +95,8 @@ EXAMPLES
   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
+  tea teams repos list 5              # list repos a team can access
+  tea teams repos add 5 myorg/myrepo  # grant a team access to a repo
 
   # 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 96ae5ef5..3daca72f 100644
--- a/docs/CLI.md
+++ b/docs/CLI.md
@@ -2085,6 +2085,52 @@ Remove a member from a team
 
 **--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
 
+### repos, repo, repositories
+
+Manage team repository access
+
+#### list, ls
+
+List team repositories
+
+**--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
+
+Grant a team access to a repository
+
+**--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
+
+Revoke a team's access to a repository
+
+**--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