gt-release-download(1)

gt-release-download1

Download release assets

Usage

gt release download [<tag>] [<asset> ...] [flags]

Overview

Download the assets of a release (default: the latest) by name or ID, those matching --pattern, or all of them; --archive downloads the source code instead. Existing files are replaced only with --clobber, and --output - writes one asset to standard output.

Options

-A, --archive=""
Download the source code archive {zip|tar.gz}

--clobber[=false]
Replace an existing file

-D, --dir=""
Directory to download into

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

-O, --output=""
File or directory to write to, or - for standard output (default: the download's name)

-p, --pattern=[]
Download the assets whose names match this glob (repeatable)

--skip-existing[=false]
Keep an existing file and skip the download

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

--remote=""
Git remote used for repository discovery

-R, --repo=""
Select a repository as OWNER/REPO or URL

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

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

Examples

# Download every asset of the latest release
$ gt release download
# Download the Linux builds of a release into dist/
$ gt release download v1.0.0 --pattern '*linux*' --dir dist
# Download the source code as a zip file
$ gt release download v1.0.0 --archive zip

From gitea-cli 1.0.0-1 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.