.nh
.TH "glab" "1" "Mar 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-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. Can use either \fBOWNER/REPO\fR or \fBGROUP/NAMESPACE/REPO\fR format. Also accepts full URL or Git URL.


.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