Home

Validate and lint your gitlab ci files using ShellCheck, the Gitlab API, curated checks or even build your own checks
Features
- ShellCheck for scripts
- Validation against Pipeline Lint API for project
- Curated checks for common mistakes (feel free to contribute new ones)
- Automatic detection of the current gitlab project with an option to overwrite
- Available as pre-commit hook
- Usable to valid dynamically generated pipelines using the python wrapper
- Support for gitlab.com and self-hosted instances
- Support for custom policies written in Rego
- Resolve and validate includes (more information on how it works and limitations)
Supported platforms
The following platforms are supported (and have prebuilt binaries / ready-to-use integration):
- Linux
- 64-bit
- ARM 64-bit
- Darwin
- 64-bit
- ARM (M1/M2)
- Windows
- 64-bit
- pre-commit (x86 & ARM)
- Docker (x86 & ARM)
Info
For installation instructions refer to Installation.
Example output
gitlab-ci-verify supports a variety of outputs.
Format | Screenshot |
---|---|
text | ![]() |
json | ![]() |
table | ![]() |