glab(1)

📦
version 1.128.0 · 12 versions
, in arch rolling

✨ glab-ci-lint — the vibe check for your .gitlab-ci.yml ✨

okay so real talk: this is the glab manual, and the specific little guy we're talking about is glab-ci-lint — the command that tells you whether your .gitlab-ci.yml file is actually valid or just... vibes. 💅

🌸 NAME 🌸

glab-ci-lint — bestie, it checks if your .gitlab-ci.yml file is valid. that's it. that's the whole job. and it ATE. 🔥

🦋 SYNOPSIS 🦋

glab ci lint [flags]

💖 DESCRIPTION 💖

so by default it looks at the .gitlab-ci.yml file chillin' in your current directory. no arguments needed, it just knows. 🫶

you can also pass a URL if you wanna validate a remote file instead — iconic, honestly. and then there's --dry-run which lets you simulate pipeline creation (like a rehearsal, but for your CI), plus --ref to set the branch or tag context for that simulation. lowkey essential. ✨

🎀 OPTIONS 🎀

  • --dry-run[=false] — runs a pipeline creation simulation. like a dress rehearsal for your pipeline, no cap. 🎭
  • --include-jobs[=false] — includes the list of jobs that would exist in a static check or pipeline simulation. so you can see exactly which jobs would show up. 👀
  • --ref="" — when --dry-run is true, this sets the branch or tag context for validating the CI/CD YAML configuration. defaults to "". 🌈

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

  • -h, --help[=false] — shows help for this command. when you're lost, this is your emotional support flag. 😭
  • -R, --repo="" — selects another repository. you can use either OWNER/REPO or GROUP/NAMESPACE/REPO, and the full URL or Git URL is also accepted. flexible queen. 👑

⭐ EXAMPLE ⭐

# Uses .gitlab-ci.yml in the current directory
glab ci lint

# Lint a specific file
glab ci lint .gitlab-ci.yml
glab ci lint path/to/.gitlab-ci.yml

like, look at that. first one's the lazy girl method (valid, respected), the rest are for when you wanna be ✨specific✨. 🍓

🧚 SEE ALSO 🧚

  • glab-ci(1) — the parent command, the main character, the one who raised this icon. 💫
ngl if your YAML is broken this command will simply tell you. it's giving tough love but make it helpful. 🫶

okay that's the whole page!! and for the cute sign-off: this lil masterpiece was auto generated by spf13/cobra, dated Nov 2026, and it belongs to the glab(1) manual. periodt. 💅✨🎀

📦 where this page comes from