gt-issue-attachment-download(1)

gt-issue-attachment-download1

Download an attachment

Usage

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

Overview

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

Examples

$ 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

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