glab(1)

📦
version 1.128.0 · 12 versions
, in arch rolling

💅 glab(1) — like, the whole manual page bestie

okay so real talk: this is page glab(1) from the glab</> manual, and today we're hyperfixating on the cluster agent list command. it's a whole vibe, it's giving "i manage kubernetes agents on gitlab and i'm thriving", and you're gonna understand every single flag by the end i promise 🫶

✨ NAME ✨

glab-cluster-agent-list — lists the GitLab Agents for Kubernetes that live in a project. that's it, that's the gig 💅

🦋 SYNOPSIS 🦋

glab cluster agent list [flags]

literally just that. nothing cursed, nothing extra 💜

🌸 DESCRIPTION 🌸

so by default it lists the agents in your current project — no flag needed, it just knows where you are, main character energy honestly 👑

and heads up: if you want JSON instead of the cute text output, pass --output json. that's the whole secret, iykyk ✨

🎀 OPTIONS 🎀

  • --jq="" — filters the JSON output with a jq expression. yes queen, pipe your JSON through jq energy right from the flag. default is empty string.
  • -F, --output="text" — formats the output as either text or json. default is text.
  • -p, --page=1 — the page number you wanna look at. defaults to 1.
  • -P, --per-page=30 — how many items per page. defaults to 30. thirty besties per page, no cap 🍓

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these aren't even this command's flags, they're handed down from the parent command, but they still work here and you should know about them 💖

  • -h, --help[=false] — shows help for this command. defaults to false. classic.
  • -R, --repo="" — selects a different repository than the one you're in. accepted formats, exactly:
    • OWNER/REPO
    • GROUP/NAMESPACE/REPO
    • the full URL is also fine
    • the Git URL is also fine

default is empty string (meaning: just use where you already are).

💀 EXAMPLE 💀

# List agents in the current project
glab cluster agent list

# List agents in JSON format
glab cluster agent list --output json

see? two lines, both iconic, both literally copy-pasteable 🔥

⭐ SEE ALSO ⭐

ngl this whole page is auto generated by spf13/cobra, dated Nov 2026, and it belongs to glab(1). so if something looks weird, blame the generator, not me 😭💀

and that's the page!! you ate that, fr fr 🎀✨ go list some agents 🧚💜

📦 where this page comes from