GitLab CI Break Lint

Runs the same checker as our npm package on a Node.js runtime that pip installs for you (nodejs-wheel-binaries) - no system Node.js needed. Your files are checked locally.

Names the .gitlab-ci.yml lines your runner will reject after the next GitLab major upgrade

Install

gitlab-ci-break-lint file

Node 18+. The same 16 rules as the VS Code extension, from a terminal or CI.

Free

• Lint the pipeline file you have open and get every retired keyword, GitHub Actions leftover and invalid job wiring with its line number and its replacement line.
• --rules lists every rule

With a licence ($29 once)

• Scan every pipeline file in the repository in one pass and export a dated Markdown upgrade report (file, line, keyword, replacement) to attach to the change ticket.

gitlab-ci-break-lint --dir ./templates --report html --out report.html

A freelance DevOps engineer's hour runs about $100, and reading a repository's pipelines by hand against a removals list is most of a morning.

Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "gitlab-ci-break-lint": { "command": "gitlab-ci-break-lint", "args": ["--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

Use in CI

- name: GitLab CI Break Lint
  run: pip install rulestamp-gitlab-ci-break-lint && gitlab-ci-break-lint --dir . --ci

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence

Install (PyPI)

pip install rulestamp-gitlab-ci-break-lint
gitlab-ci-break-lint --help