GH-RELEASE-DOWNLOAD(1) GitHub CLI manual GH-RELEASE-DOWNLOAD(1)

# [NAME](#NAME)

gh-release-download - Download release assets

# [SYNOPSIS](#SYNOPSIS)

**gh release download \[<tag>] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Download assets from a GitHub release.

Without an explicit tag name argument, assets are downloaded from the latest release in the project. In this case, **--pattern** or **--archive** is required.

# [OPTIONS](#OPTIONS)

[**--allow-escape-sequences**](#allow_escape_sequences)

Allow printing terminal escape sequences when writing an asset to standard output

[**-A**, **--archive** **<format>**](#A)

Download the source code archive in the specified format (zip or tar.gz)

[**--clobber**](#clobber)

Overwrite existing files of the same name

[**-D**, **--dir** **<directory> (default ".")**](#D)

The directory to download files into

[**-O**, **--output** **<file>**](#O)

The file to write a single asset to (use "-" to write to standard output)

[**-p**, **--pattern** **<stringArray>**](#p)

Download only assets that match a glob pattern

[**--skip-existing**](#skip_existing)

Skip downloading when files of the same name exist

# [OPTIONS INHERITED FROM PARENT COMMANDS](#OPTIONS_INHERITED_FROM_PARENT_COMMANDS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [EXIT CODES](#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](#EXAMPLE)

```
# Download all assets from a specific release
$ gh release download v1.2.3
# Download only Debian packages for the latest release
$ gh release download --pattern '*.deb'
# Specify multiple file patterns
$ gh release download -p '*.deb' -p '*.rpm'
# Download the archive of the source code for a release
$ gh release download v1.2.3 --archive=zip
```

# [SEE ALSO](#SEE_ALSO)

[**gh-release(1)**](/man/os/gh/gh-release.1)

Oct 2026

---

Document: gh-release-download(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli