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

.SH NAME
glab-runner-list - List runners.


.SH SYNOPSIS
\fBglab runner list [flags]\fP


.SH DESCRIPTION
List runners for a project (default), group, or instance.

.PP
Instance scope requires administrator access.


.SH OPTIONS
\fB-g\fP, \fB--group\fP=""
	List runners for a group. Ignored if -R/--repo is set.

.PP
\fB-i\fP, \fB--instance\fP[=false]
	List all runners available to the user (instance scope).

.PP
\fB--jq\fP=""
	Filter JSON output with a jq expression.

.PP
\fB-F\fP, \fB--output\fP="text"
	Format output as: text, json.

.PP
\fB-p\fP, \fB--page\fP=1
	Page number.

.PP
\fB-P\fP, \fB--per-page\fP=30
	Number of items to list per page.

.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 OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# List runners for the current project
glab runner list

# List runners for a specific project
glab runner list -R owner/repo

# List runners for a group
glab runner list --group mygroup

# List runners as JSON
glab runner list --output json
.EE


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