table of contents
| GH-ISSUE-ARTIFACT-DOWNLOAD(1) | GitHub CLI manual | GH-ISSUE-ARTIFACT-DOWNLOAD(1) |
NAME¶
gh-issue-artifact-download - Download issue artifacts (preview)
SYNOPSIS¶
gh issue artifact download {<issue> [<artifact-number>...] | <artifact-url>...} [flags]
DESCRIPTION¶
Download issue artifacts to files. Without artifact numbers, every artifact on the issue is downloaded. Artifacts can also be named by their URLs, which must all be on one issue. <issue> is an issue number or URL.
Each file is named <number>-<name>. Markdown documents end in .md, HTML documents in .html, and links are saved as .url Internet Shortcut files. If a file already exists, that artifact fails unless you use --clobber to overwrite it or --skip-existing to skip it.
Use --dir to choose the directory to download files into, --output to choose the path for a single artifact, or --output - to print its content. Use --version with a single artifact to download an earlier version from its edit history.
OPTIONS¶
- --clobber
- Overwrite existing files of the same name
- -D, --dir <directory> (default ".")
- The directory to download files into
- -O, --output <file>
- The file to write a single artifact to (use "-" to write to standard output)
- --skip-existing
- Skip downloading when files of the same name exist
- --version <number> (default 0)
- Download the version with this number from the edit history
OPTIONS INHERITED FROM PARENT COMMANDS¶
- -R, --repo <[HOST/]OWNER/REPO>
- Select another repository using the [HOST/]OWNER/REPO format
EXIT CODES¶
0: Successful execution
1: Error
2: Command canceled
4: Authentication required
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.
EXAMPLE¶
# Download every artifact on issue 142 $ gh issue artifact download 142 # Download two artifacts into a folder $ gh issue artifact download 142 2 5 --dir notes # Print one artifact's content $ gh issue artifact download 142 2 --output - # Download an earlier version of one artifact $ gh issue artifact download 142 2 --version 5
SEE ALSO¶
| Oct 2026 | GitHub CLI v2.103.3 |