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

.SH NAME
glab-ci-list - List CI/CD pipelines.


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


.SH DESCRIPTION
Defaults to the current project. Use \fB--status\fR to filter pipelines by status.


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

.PP
\fB-n\fP, \fB--name\fP=""
	Return only pipelines with the given name.

.PP
\fB-o\fP, \fB--order\fP="id"
	Order pipelines by this field. Options: id, status, ref, updated_at, user_id.

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

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

.PP
\fB-P\fP, \fB--per-page\fP=0
	Number of items to list per page. Defaults to the GitLab API default (20).

.PP
\fB-r\fP, \fB--ref\fP=""
	Return only pipelines for the given ref.

.PP
\fB--scope\fP=""
	Return only pipelines with the given scope. Options: running, pending, finished, branches, tags.

.PP
\fB--sha\fP=""
	Return only pipelines with the given SHA.

.PP
\fB--sort\fP="desc"
	Sort direction for '--order': asc or desc.

.PP
\fB--source\fP=""
	Return only pipelines triggered by the given source. For the full list, see https://docs.gitlab.com/ci/jobs/job_rules/#ci_pipeline_source-predefined-variable. Commonly used options: merge_request_event, parent_pipeline, pipeline, push, trigger.

.PP
\fB-s\fP, \fB--status\fP=""
	Filter pipelines by status. Options: running, pending, success, failed, canceled, skipped, created, manual, waiting_for_resource, preparing, scheduled.

.PP
\fB-a\fP, \fB--updated-after\fP=""
	Return only pipelines updated after the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z).

.PP
\fB-b\fP, \fB--updated-before\fP=""
	Return only pipelines updated before the specified date. Expected in ISO 8601 format (2019-03-15T08:00:00Z).

.PP
\fB-u\fP, \fB--username\fP=""
	Return only pipelines triggered by the given username.

.PP
\fB-y\fP, \fB--yaml-errors\fP[=false]
	Return only pipelines with invalid configurations.


.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
glab ci list
glab ci list --status=failed
.EE


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