initial

references/tea/setup.md

@@ -0,0 +1,19 @@
+# tea CLI — SETUP
+
+See [`./index.md`](./index.md) for global options and common flags shared by all commands.
+
+## `tea logins` (alias: `login`)
+- `list, ls`
+- `add` — interactive when called without args. `--name/-n`, `--url/-u` (`$GITEA_SERVER_URL`), `--token/-t` (`$GITEA_SERVER_TOKEN`), `--user` (`$GITEA_SERVER_USER`), `--password/--pwd` (`$GITEA_SERVER_PASSWORD`), `--otp` (`$GITEA_SERVER_OTP`), `--scopes` (`$GITEA_SCOPES`), `--ssh-key/-s`, `--ssh-agent-principal/-c`, `--ssh-agent-key/-a`, `--insecure/-i`, `--no-version-check/--nv`, `--helper/-j`, `--oauth/-o` (plus `--client-id`, `--redirect-url`).
+- `edit, e` — interactive.
+- `delete, rm <name>`
+- `default [<login>]` — get or set the default login.
+- `oauth-refresh [<login>]` — refresh an OAuth token (opens browser if the refresh token is also expired).
+
+## `tea logout <name>`
+Remove a stored login.
+
+## `tea ssh-keys` (alias: `ssh-key`)
+- `list, ls`
+- `add <key-file>` — `--title/-t` (defaults to filename without extension).
+- `delete, rm <key-id>` — `--confirm/-y`.