GitLabgitlab-org

cli

main
ply7 git calls292 ms99 KiB4 cachedprotocol v2
107 lines4.9 KiBRaw

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

Synopsis

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.

Date filters accept:

  • An absolute date (YYYY-MM-DD). A date without a time is read in the system time zone of the GitLab server.
  • An RFC 3339 timestamp. Use one with an offset, such as 2026-01-01T00:00:00+02:00, for an exact point in time.
  • A relative date: a number followed by d (days), w (weeks), m (months), or y (years). Negative numbers are in the past, positive numbers are in the future, and 0d is today. Relative dates resolve to the start of the day in the time zone of the GitLab instance. They stay relative, so the same command keeps returning the last 7 days, for example.

Date filters require GitLab 19.4 or later. Relative dates require GitLab 19.6 or later.

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

plaintext
glab work-items list [flags]

Aliases

plaintext
ls

Examples

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

# List work items created in the last 7 days
glab work-items list --created-after -7d -g gitlab-org

# List open work items due in the next 2 weeks
glab work-items list --due-after 0d --due-before 2w -g gitlab-org

# List work items closed in a fixed date range
glab work-items list --state closed --closed-after 2026-01-01 --closed-before 2026-04-01 -g gitlab-org

Options

plaintext
      --after string          Fetch items after this cursor (for pagination)
      --closed-after date     Show work items closed on or after <date>. Implies --state closed unless --state is set. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --closed-before date    Show work items closed before <date>. Implies --state closed unless --state is set. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --created-after date    Show work items created on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --created-before date   Show work items created before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --due-after date        Show work items due on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --due-before date       Show work items due before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  -g, --group string          List work items for a group or subgroup.
      --jq string             Filter JSON output with a jq expression.
  -F, --output string         Format output as: text, json. (default "text")
  -P, --per-page int          Number of items to list per page (max 100) (default 20)
  -R, --repo string           Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
      --state string          Filter by state: opened, closed, all. (default "opened")
  -t, --type strings          Filter by work item type (epic, issue, task, etc.) Multiple types can be comma-separated or specified by repeating the flag.
      --updated-after date    Show work items updated on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
      --updated-before date   Show work items updated before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.

Options inherited from parent commands

plaintext
  -h, --help   Show help for this command.
1---
2title: '`glab work-items list`'
3stage: AI Clients
4group: Developer Clients
5info: To determine the technical writer assigned to the Stage/Group associated with this page, see <https://handbook.gitlab.com/handbook/marketing/product-and-technical-marketing/technical-writing/#assignments>
6---
8<!--
9This documentation is auto generated by a script.
10Please do not edit this file directly. Run `make gen-docs` instead.
11-->
13List work items in a project or group. (EXPERIMENTAL)
15## Synopsis
17List work items in a project or group.
19Automatically detects scope from repository context. Use --group flag
20for group-level work items or -R to specify a different project.
22Date filters accept:
24- An absolute date (YYYY-MM-DD). A date without a time is read in the system time zone of the GitLab server.
25- An RFC 3339 timestamp. Use one with an offset, such as 2026-01-01T00:00:00+02:00, for an exact point in time.
26- A relative date: a number followed by d (days), w (weeks), m (months), or y (years). Negative numbers are in the past, positive numbers are in the future, and 0d is today. Relative dates resolve to the start of the day in the time zone of the GitLab instance. They stay relative, so the same command keeps returning the last 7 days, for example.
28Date filters require GitLab 19.4 or later. Relative dates require GitLab 19.6 or later.
30This feature is an experiment and is not ready for production use.
31It might be unstable or removed at any time.
32For more information, see
33<https://docs.gitlab.com/policy/development_stages_support/>.
35```plaintext
36glab work-items list [flags]
37```
39## Aliases
41```plaintext
42ls
43```
45## Examples
47```console
48# List first 20 open work items in current project
49glab work-items list
51# List open epics in a group (default: 20 items)
52glab work-items list --type epic -g gitlab-org
54# List first 50 open work items
55glab work-items list --per-page 50 -g gitlab-org
57# Get next page using cursor from previous output
58glab work-items list --after "eyJpZCI6OTk5OX0" -g gitlab-org
60# List closed work items
61glab work-items list --state closed -g gitlab-org
63# List all work items regardless of state
64glab work-items list --state all -g gitlab-org
66# JSON output with pagination metadata
67glab work-items list --output json -g gitlab-org
69# List issues in a specific project
70glab work-items list --type issue -R gitlab-org/cli
72# List work items created in the last 7 days
73glab work-items list --created-after -7d -g gitlab-org
75# List open work items due in the next 2 weeks
76glab work-items list --due-after 0d --due-before 2w -g gitlab-org
78# List work items closed in a fixed date range
79glab work-items list --state closed --closed-after 2026-01-01 --closed-before 2026-04-01 -g gitlab-org
80```
82## Options
84```plaintext
85 --after string Fetch items after this cursor (for pagination)
86 --closed-after date Show work items closed on or after <date>. Implies --state closed unless --state is set. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
87 --closed-before date Show work items closed before <date>. Implies --state closed unless --state is set. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
88 --created-after date Show work items created on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
89 --created-before date Show work items created before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
90 --due-after date Show work items due on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
91 --due-before date Show work items due before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
92 -g, --group string List work items for a group or subgroup.
93 --jq string Filter JSON output with a jq expression.
94 -F, --output string Format output as: text, json. (default "text")
95 -P, --per-page int Number of items to list per page (max 100) (default 20)
96 -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
97 --state string Filter by state: opened, closed, all. (default "opened")
98 -t, --type strings Filter by work item type (epic, issue, task, etc.) Multiple types can be comma-separated or specified by repeating the flag.
99 --updated-after date Show work items updated on or after <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
100 --updated-before date Show work items updated before <date>. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
101```
103## Options inherited from parent commands
105```plaintext
106 -h, --help Show help for this command.
107```
Diagnostics7 git calls · 292 ms
CallStatusSizeTime0292 ms
discover200185 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=59849
git.response.cache=UPDATING
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchtree:02001.7 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
git.response.bytes=1744
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=5e4007a5673eb3bf5d0d7f1a1463c3b2ca3fb3bd
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1744
git.pkt.payload.max=1717
git.sideband.band1.bytes=1717
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1717
git.pack.trailer=3f1b9ccc7756e8941d6705e8187c87fd922113e6
Open pack map
fetchtree:0200226 B · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=281
git.response.bytes=226
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=tree:0
git.fetch.wants=6023826ffccf67d62168a71d6c590336f6e01dec
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=226
git.pkt.payload.max=199
git.sideband.band1.bytes=199
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=199
git.pack.trailer=0dc57e2ae7461493f34493a1c28ae25cdea607cd
Open pack map
fetch2001.8 KiB281 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1793
git.response.cache=MISS
git.response.duration_ms=281
git.fetch.wants=ca00a9dbeb76f09be4bab53347b392db4ba1c8af
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1793
git.pkt.payload.max=1766
git.sideband.band1.bytes=1766
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e153823c910acb
Request
e310cb41…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format