GT-EXTENSION(1) gitea-cli Manual GT-EXTENSION(1)

gt-extension - Manage gt extensions

gt extension [flags]

Install, run and remove extensions: executables named gt-NAME that run as gt NAME.

Extensions come from repositories on Gitea instances, or as GitHub CLI extensions named gh-NAME from github.com; gt runs the gh extensions that do not depend on GitHub's own APIs. Built-in commands always win over an extension of the same name; gt extension exec runs it anyway.

gt passes the global flags --host, --repo and --user before the extension's name on as GITEA_CLI_HOST, GITEA_CLI_REPO and GITEA_CLI_USER, runs it in --cwd, accepts --no-input and --yes, refuses other global flags, and passes everything after its name on unchanged. Extensions do not get your Gitea token unless you allowed it at install. See gt help extensions for the security model.

-h, --help[=false] help for extension

--cwd="" Working directory for repository discovery

--debug[=false] Log the method, URL, status, and duration of each HTTP request to stderr

--host="" Gitea instance URL, including any base path

--interactive[=false] Allow prompts with machine output

--no-input[=false] Disable prompts and implicit editor/browser interactions

--sudo="" Perform API requests as this user (requires an administrator account)

--user="" Account name on the selected instance

gt(1), gt-extension-browse(1), gt-extension-create(1), gt-extension-exec(1), gt-extension-install(1), gt-extension-list(1), gt-extension-remove(1), gt-extension-search(1), gt-extension-upgrade(1)

Nov 2026 gitea-cli