table of contents
| 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¶
| Nov 2026 | gitea-cli |