Scroll to navigation

GT-RUN-DOWNLOAD(1) gitea-cli Manual GT-RUN-DOWNLOAD(1)

NAME

gt-run-download - Download the artifacts of a run

SYNOPSIS

gt run download [<run-id>] [flags]

DESCRIPTION

Download the artifacts of a run and extract them.

Each artifact is extracted into a directory named after it, except a single artifact selected with --name, which is extracted into the destination directory itself. With --zip, the artifacts are saved as ZIP archives instead.

ARGUMENTS

A run can be supplied as its ID ("34", "#34") or its URL
("https://gitea.example.com/OWNER/REPO/actions/runs/34"). Without an argument,
gt asks for one of the repository's recent runs in a terminal.

OPTIONS

--clobber[=false] Replace an existing file

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

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

-n, --name=[] Only download the artifacts with these names

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

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

--zip[=false] Save each artifact as a ZIP archive instead of extracting it

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

EXAMPLE

# download every artifact of a run into ./<artifact name>/
$ gt run download 34
# extract one artifact into dist/
$ gt run download 34 --name build --dir dist
# save the artifacts as ZIP archives
$ gt run download 34 --zip

SEE ALSO

gt-run(1)

Nov 2026 gitea-cli