.nh
.TH "GH-RUN-DOWNLOAD" "1" "Oct 2022" "" "GitHub CLI manual"

.SH NAME
.PP
gh-run-download - Download artifacts generated by a workflow run


.SH SYNOPSIS
.PP
\fB\fCgh run download [<run-id>] [flags]\fR


.SH DESCRIPTION
.PP
Download artifacts generated by a GitHub Actions workflow run.

.PP
The contents of each artifact will be extracted under separate directories based on
the artifact name. If only a single artifact is specified, it will be extracted into
the current directory.


.SH OPTIONS
.TP
\fB\fC-D\fR, \fB\fC--dir\fR \fB\fC<string>\fR
The directory to download artifacts into

.TP
\fB\fC-n\fR, \fB\fC--name\fR \fB\fC<stringArray>\fR
Download artifacts that match any of the given names

.TP
\fB\fC-p\fR, \fB\fC--pattern\fR \fB\fC<stringArray>\fR
Download artifacts that match a glob pattern


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.TP
\fB\fC-R\fR, \fB\fC--repo\fR \fB\fC<[HOST/]OWNER/REPO>\fR
Select another repository using the [HOST/]OWNER/REPO format


.SH EXAMPLE
.PP
.RS

.nf
# Download all artifacts generated by a workflow run
$ gh run download <run-id>

# Download a specific artifact within a run
$ gh run download <run-id> -n <name>

# Download specific artifacts across all runs in a repository
$ gh run download -n <name1> -n <name2>

# Select artifacts to download interactively
$ gh run download


.fi
.RE


.SH SEE ALSO
.PP
\fB\fCgh-run(1)\fR