1GH-RELEASE-DOWNLOAD(1)         GitHub CLI manual        GH-RELEASE-DOWNLOAD(1)
2
3
4

NAME

6       gh-release-download - Download release assets
7
8
9

SYNOPSIS

11       gh release download [<tag>] [flags]
12
13
14

DESCRIPTION

16       Download assets from a GitHub release.
17
18
19       Without  an  explicit tag name argument, assets are downloaded from the
20       latest release in the project. In this case, "--pattern" or "--archive"
21                            is required.
22
23
24

OPTIONS

26       -A, --archive <format>
27              Download the source code archive in the specified format (zip or
28              tar.gz)
29
30
31       --clobber
32              Overwrite existing files of the same name
33
34
35       -D, --dir <directory>
36              The directory to download files into
37
38
39       -O, --output <file>
40              The  file  to write a single asset to (use "-" to write to stan‐
41              dard output)
42
43
44       -p, --pattern <stringArray>
45              Download only assets that match a glob pattern
46
47
48       --skip-existing
49              Skip downloading when files of the same name exist
50
51
52

OPTIONS INHERITED FROM PARENT COMMANDS

54       -R, --repo <[HOST/]OWNER/REPO>
55              Select another repository using the [HOST/]OWNER/REPO format
56
57
58

EXAMPLE

60       # download all assets from a specific release
61       $ gh release download v1.2.3
62
63       # download only Debian packages for the latest release
64       $ gh release download --pattern '*.deb'
65
66       # specify multiple file patterns
67       $ gh release download -p '*.deb' -p '*.rpm'
68
69       # download the archive of the source code for a release
70       $ gh release download v1.2.3 --archive=zip
71
72
73
74
75

SEE ALSO

77       gh-release(1)
78
79
80
81                                   Nov 2023             GH-RELEASE-DOWNLOAD(1)