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

.SH NAME
glab-work-items-list - List work items in a project or group. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab work-items list [flags]\fP


.SH DESCRIPTION
List work items in a project or group.

.PP
Automatically detects scope from repository context. Use --group flag
for group-level work items or -R to specify a different project.

.PP
This feature is an experiment and is not ready for production use.
It might be unstable or removed at any time.
For more information, see
https://docs.gitlab.com/policy/development_stages_support/.


.SH OPTIONS
\fB--after\fP=""
	Fetch items after this cursor (for pagination)

.PP
\fB-g\fP, \fB--group\fP=""
	List work items for a group or subgroup

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

.PP
\fB-P\fP, \fB--per-page\fP=20
	Number of items to list per page (max 100)

.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.

.PP
\fB--state\fP="opened"
	Filter by state: opened, closed, all

.PP
\fB-t\fP, \fB--type\fP=[]
	Filter by work item type (epic, issue, task, etc.) Multiple types can be comma-separated or specified by repeating the flag.


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


.SH EXAMPLE
.EX
# List first 20 open work items in current project
$ glab work-items list

# List open epics in a group (default: 20 items)
$ glab work-items list --type epic -g gitlab-org

# List first 50 open work items
$ glab work-items list --per-page 50 -g gitlab-org

# Get next page using cursor from previous output
$ glab work-items list --after "eyJpZCI6OTk5OX0" -g gitlab-org

# List closed work items
$ glab work-items list --state closed -g gitlab-org

# List all work items regardless of state
$ glab work-items list --state all -g gitlab-org

# JSON output with pagination metadata
$ glab work-items list --output json -g gitlab-org

# List issues in a specific project
$ glab work-items list --type issue -R gitlab-org/cli

.EE


.SH SEE ALSO
\fBglab-work-items(1)\fP