---
name: "gt-extension"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-extension"
---

# gt-extension(1)

Manage gt extensions

## NAME

gt-extension - Manage gt extensions

## SYNOPSIS

**gt extension \[flags\]**

## DESCRIPTION

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.

## OPTIONS

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

## OPTIONS INHERITED FROM PARENT COMMANDS

**--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

## SEE ALSO

**[gt(1)](/man/gt/1.md)**, **[gt-extension-browse(1)](/man/gt-extension-browse/1.md)**, **[gt-extension-create(1)](/man/gt-extension-create/1.md)**, **[gt-extension-exec(1)](/man/gt-extension-exec/1.md)**, **[gt-extension-install(1)](/man/gt-extension-install/1.md)**, **[gt-extension-list(1)](/man/gt-extension-list/1.md)**, **[gt-extension-remove(1)](/man/gt-extension-remove/1.md)**, **[gt-extension-search(1)](/man/gt-extension-search/1.md)**, **[gt-extension-upgrade(1)](/man/gt-extension-upgrade/1.md)**