gh-run-download.1

.nh
.TH "gh" "1" "Jun 2021" "" ""

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


.SH SYNOPSIS
.PP
\fBgh run download [] [flags]\fP


.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
.PP
\fB\-D\fP, \fB\-\-dir\fP="."
	The directory to download artifacts into

.PP
\fB\-n\fP, \fB\-\-name\fP=[]
	Only download artifacts that match any of the given names


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB\-\-help\fP[=false]
	Show help for command

.PP
\fB\-R\fP, \fB\-\-repo\fP=""
	Select another repository using the \fB\fC[HOST/]OWNER/REPO\fR 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
\fBgh\-run(1)\fP