---
name: "glab-work-items-list"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-work-items-list"
---

# glab-work-items-list(1)

List work items in a project or group. (EXPERIMENTAL)

## NAME

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

## SYNOPSIS

**glab work-items list \[flags\]**

## DESCRIPTION

List work items in a project or group.

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

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

## OPTIONS

**--after**=""\
 	Fetch items after this cursor (for pagination)

**-g**, **--group**=""\
 	List work items for a group or subgroup.

**--jq**=""\
 	Filter JSON output with a jq expression.

**-F**, **--output**="text"\
 	Format output as: text, json.

**-P**, **--per-page**=20\
 	Number of items to list per page (max 100)

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

**--state**="opened"\
 	Filter by state: opened, closed, all.

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

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

## EXAMPLE

```
# 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
```

## SEE ALSO

**[glab-work-items(1)](/glab-work-items/1.md)**