glab(1)

📦
version 1.128.0 · 6 versions
, in arch rolling

💅 NAME 💅

glab-work-items-list — the glow-up command for listing work items in a project or group 🎀

heads up bestie: this one is (EXPERIMENTAL) 🧪✨

(it's a glab(1) situation, so you already know the vibe — GitLab CLI, but make it cute)

✨ SYNOPSIS ✨

glab work-items list [flags]

🦋 DESCRIPTION 🦋

Okay so, literally: list work items in a project or group. That's the whole assignment. 👑

It's lowkey smart about it too — it automatically detects scope from repository context. So if you're sitting in a repo, it already knows. Want group-level work items instead? Slap on the --group flag. Want a totally different project? Use -R and pick your fave. Easy. 💅

🌸 Date filters, explained (this is the good part)

Date filters accept three flavors, and yes you can mix and match:

  • 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.
⚠️ Version check bestie!! Date filters require GitLab 19.4 or later. Relative dates require GitLab 19.6 or later. Don't come crying to me if you're on 19.3 😭
💀 EXPERIMENTAL ALERT — 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) ⏭️
  • --closed-after= — Show work items closed on or after this. 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= — Show work items closed before this. 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= — Show work items created on or after this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  • --created-before= — Show work items created before this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  • --due-after= — Show work items due on or after this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  • --due-before= — Show work items due before this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  • -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. 🔁
  • --updated-after= — Show work items updated on or after this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.
  • --updated-before= — Show work items updated before this. Use YYYY-MM-DD, an RFC 3339 timestamp, or a relative date such as -7d, 2w, -1m, or 1y.

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

  • -h, --help[=false] — Show help for this command. (the classic, the icon, the moment 🫶)

🌈 EXAMPLE 🌈

Screenshot this, bestie — these are all verbatim, no cap:

# 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

⭐ SEE ALSO ⭐

okay that's the whole page, mwah 💋 this one was auto generated by spf13/cobra, dated Nov 2026 — she's a robot but she's slaying fr fr 🎀✨

📦 where this page comes from