docs(collaborators): document the new 'tea collaborators' command

- CHANGELOG.md: add an Unreleased entry under FEATURES
- README.md:    add usage examples after the webhooks examples
- docs/CLI.md:  regenerate via 'go run docs/docs.go' to include the
                new command's full flag/option reference

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## Unreleased
+
+* FEATURES
+  * Add `tea collaborators` command for managing repository collaborators (`tea collaborators list`, `tea collaborators create <username> --permission <level>`, `tea collaborators delete <username>`, `tea collaborators permission <username>`)
+
 ## [v0.13.0](https://gitea.com/gitea/tea/releases/tag/v0.13.0) - 2026-04-05
 
 * FEATURES

README.md

@@ -88,6 +88,11 @@ EXAMPLES
   tea webhooks list --org myorg       # list organization webhooks
   tea webhooks create https://example.com/hook --events push,pull_request
 
+  tea collaborators list               # list repository collaborators
+  tea collaborators create alice --permission write
+  tea collaborators delete alice -y   # remove a collaborator without prompting
+  tea collaborators alice              # shortcut for 'permission alice'
+
   # 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

@@ -2015,6 +2015,72 @@ Delete one or more comments by ID
 
 **--repo, -r**="": Override local repository path or gitea repository slug to interact with. Optional
 
+## collaborators, collaborator, collab
+
+Manage repository collaborators
+
+**--login**="": gitea login instance to use
+
+**--output, -o**="": output format [table, csv, simple, tsv, yaml, json]
+
+**--repo**="": repository to operate on
+
+### list, ls
+
+List collaborators
+
+**--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
+
+Create a collaborator
+
+**--login, -l**="": Use a different Gitea Login. Optional
+
+**--output, -o**="": Output format. (simple, table, csv, tsv, yaml, json)
+
+**--permission**="": permission level for the collaborator (read, write, admin) (default: "write")
+
+**--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
+
+Delete a collaborator
+
+**--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
+
+### permission, perm
+
+Check collaborator permission
+
+**--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
+
 ## open, o
 
 Open something of the repository in web browser