Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
GH-RUN-DOWNLOAD(1)		GitHub CLI manual	      GH-RUN-DOWNLOAD(1)

NAME
     gh-run-download - Download artifacts generated by a workflow run

SYNOPSIS
     gh run download [<run-id>] [flags]

DESCRIPTION
     Download artifacts generated by a GitHub Actions workflow run.

     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.

     By default, this command downloads the latest artifact created and uploaded
     through GitHub Actions. Because workflows can  delete  or	overwrite  arti-
     facts, <run-id> must be used to select an artifact from a specific workflow
     run.

OPTIONS
     -D, --dir <string> (default ".")
	    The directory to download artifacts into

     -n, --name <stringArray>
	    Download artifacts that match any of the given names

     -p, --pattern <stringArray>
	    Download artifacts that match a glob pattern

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 com-
     mand's help for more information.

EXAMPLE
     # 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

SEE ALSO
     gh-run(1)

				    Aug 2026		      GH-RUN-DOWNLOAD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-run-download&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help