feat: generate the gt command reference from gitea/cli

update_cli_docs.sh runs gt's own generator and lays the pages out for the
site: one directory per command group, front matter, titles, sidebar
order, fenced help text and rewritten links. --released succeeds while no
series is documented. A weekly workflow proposes updates like the runner's.

Signed-off-by: bircni <[email protected]>

cli-docs/reference/index.md

@@ -0,0 +1,74 @@
+---
+sidebar_position: 0
+description: "Work with Gitea from your terminal"
+---
+
+# Command reference
+
+<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
+
+Every `gt` command and flag, generated from the `--help` output of gt's main branch
+or release. Global flags work with every command; [gt help environment](help/environment.md)
+describes them together with the environment variables gt reads.
+
+Work with Gitea from your terminal
+
+## Synopsis
+
+```text
+Work seamlessly with Gitea from the command line.
+```
+
+```
+gt [flags]
+```
+
+## Options
+
+```
+      --cwd directory       Working directory for repository discovery
+      --debug               Log the method, URL, status, and duration of each HTTP request to stderr
+  -h, --help                help for gt
+      --host URL            Gitea instance URL, including any base path
+      --interactive         Allow prompts with machine output
+  -q, --jq expression       Filter JSON output using a jq expression; implies --json
+      --json fields[="*"]   Output JSON with the specified comma-separated fields, or all fields
+      --no-input            Disable prompts and implicit editor/browser interactions
+      --remote remote       Git remote used for repository discovery
+  -R, --repo OWNER/REPO     Select a repository as OWNER/REPO or URL
+      --sudo user           Perform API requests as this user (requires an administrator account)
+      --user name           Account name on the selected instance
+  -y, --yes                 Accept confirmations without prompting
+```
+
+## SEE ALSO
+
+* [gt admin](admin/index.md): Manage instance administration
+* [gt alias](alias/index.md): Create shortcuts for gt commands
+* [gt api](api.md): Make an authenticated Gitea API request
+* [gt auth](auth/index.md): Authenticate gt and git with Gitea
+* [gt branch](branch/index.md): Manage remote branches and protection rules
+* [gt completion](completion/index.md): Generate shell completion scripts
+* [gt config](config/index.md): Manage settings
+* [gt doctor](doctor.md): Check gt's setup for this directory
+* [gt issue](issue/index.md): Manage issues
+* [gt label](label/index.md): Manage labels
+* [gt milestone](milestone/index.md): Manage milestones
+* [gt notification](notification/index.md): Read and triage your notifications
+* [gt org](org/index.md): Manage organizations
+* [gt package](package/index.md): Manage packages
+* [gt pr](pr/index.md): Manage pull requests
+* [gt release](release/index.md): Manage releases
+* [gt repo](repo/index.md): Work with Gitea repositories
+* [gt run](run/index.md): View and manage Actions workflow runs
+* [gt search](search/index.md): Search within one selected Gitea instance
+* [gt secret](secret/index.md): Manage Actions secrets for a repository, organization, or your account
+* [gt ssh-key](ssh-key/index.md): Manage SSH keys
+* [gt status](status.md): Show your work across repositories
+* [gt team](team/index.md): Manage organization teams and access
+* [gt time](time/index.md): Track time spent on issues and pull requests
+* [gt variable](variable/index.md): Manage Actions variables for a repository, organization, or your account
+* [gt version](version.md): Print gt's version
+* [gt webhook](webhook/index.md): Manage webhooks
+* [gt wiki](wiki/index.md): Manage repository wiki pages
+* [gt workflow](workflow/index.md): View, run, enable and disable Actions workflows