glab-ci-lint(1)

glab-ci-lint1

Check if your .gitlab-ci.yml file is valid.

Usage

glab ci lint [flags]

Overview

Defaults to the .gitlab-ci.yml file in the current directory. You can also pass a URL to validate a remote file. Use --dry-run to simulate pipeline creation, and --ref to set the branch or tag context for the simulation.

Options

--dry-run[=false]
Run pipeline creation simulation.

--include-jobs[=false]
Include the list of jobs that would exist in a static check or pipeline simulation.

--ref=""
When '--dry-run' is true, sets the branch or tag context for validating the CI/CD YAML configuration.

Options inherited from parent commands

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

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

Examples

# 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

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

From glab 1.126.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.