Scroll to navigation

GT-ISSUE-ATTACHMENT-DOWNLOAD(1) gitea-cli Manual GT-ISSUE-ATTACHMENT-DOWNLOAD(1)

NAME

gt-issue-attachment-download - Download an attachment

SYNOPSIS

gt issue attachment download {<number> | <url>} <attachment-id> [flags]

DESCRIPTION

Download an attachment into the current directory under its own name, or where -O/--output or -D/--dir say. An existing file is kept unless --clobber replaces it or --skip-existing skips the download.

ARGUMENTS

An issue can be supplied as argument in any of the following formats:
- by number, e.g. "123" or "#123"
- by URL, e.g. "https://gitea.com/OWNER/REPO/issues/123"
- by repository and number, e.g. "OWNER/REPO#123"
Several issues must be in one repository. Next to "OWNER/REPO#123" or a URL, "124" means
OWNER/REPO#124, unless gt targets another repository otherwise, such as the clone's, --repo
or GITEA_CLI_REPO: then the command fails, and the number must be qualified.

OPTIONS

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

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

EXAMPLE

$ gt issue attachment download 12 9
$ gt issue attachment download 12 9 --output crash.log --clobber
# Write the file to standard output
$ gt issue attachment download 12 9 -O - | less

SEE ALSO

gt-issue-attachment(1)

Nov 2026 gitea-cli