.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-securefile-download - Download one or more secure files from a project.


.SH SYNOPSIS
\fBglab securefile download [ | --id  | --name ] [flags]\fP


.SH DESCRIPTION
To download a single file, identify it by its numeric ID (as a positional
argument or with \fB--id\fR) or by its name with \fB--name\fR\&. To download every
secure file in the project, use \fB--all\fR\&.

.PP
Use \fB--path\fR to save a single download to a specific filename, or
\fB--output-dir\fR to choose the destination directory when downloading
multiple files.

.PP
By default, downloaded files are verified against their checksum.
Use \fB--no-verify\fR to skip verification, or \fB--force-download\fR to keep
files even when verification fails. Both options can allow corrupted
or tampered files; use with caution.

.PP
By default, files are downloaded from the current project. Use
\fB--repo\fR to target another project.


.SH OPTIONS
\fB--all\fP[=false]
	Download all of a project's secure files. Files are downloaded with their original name and file extension.

.PP
\fB--force-download\fP[=false]
	Force download file(s) even if checksum verification fails. Warning: when enabled, this setting allows the download of files that are corrupt or tampered with.

.PP
\fB--id\fP=0
	ID of the secure file to download.

.PP
\fB--name\fP=""
	Name of the secure file to download. Saves the file with this name, or to the path specified by --path.

.PP
\fB--no-verify\fP[=false]
	Do not verify the checksum of the downloaded file(s). Warning: when enabled, this setting allows the download of files that are corrupt or tampered with.

.PP
\fB--output-dir\fP="."
	Output directory for files downloaded with --all.

.PP
\fB-p\fP, \fB--path\fP="./downloaded.tmp"
	Path to download the secure file to, including filename and extension.


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

.PP
\fB-R\fP, \fB--repo\fP=""
	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.


.SH EXAMPLE
.EX
# Download a file by ID (positional or flag)
glab securefile download 1
glab securefile download --id 1

# Download a file by ID to a specific path
glab securefile download 1 --path "securefiles/file.txt"

# Download a file to an absolute path
glab securefile download 1 --path /tmp/secure/file.txt

# Download a file by name to the current directory
glab securefile download --name my-secure-file.pem

# Download a file by name to a chosen path
glab securefile download --name my-secure-file.pem --path securefiles/some-other-name.pem

# Download without verifying the checksum
glab securefile download 1 --no-verify

# Download all secure files in the project
glab securefile download --all

# Download all secure files to a specific directory
glab securefile download --all --output-dir secure_files/

.EE


.SH SEE ALSO
\fBglab-securefile(1)\fP