yamllint
brew install yamllint
v1.38.0
GPL-3.0-or-later
Python linter for YAML files that checks syntax, style, and common mistakes like key repetition and trailing spaces.
Why you might care
Catches both syntax errors and cosmetic YAML problems (indentation, line length, trailing whitespace, duplicate keys) in CI/CD pipelines and pre-commit hooks. Highly configurable rules and integrates well with editor plugins and linting workflows. Essential for teams enforcing consistent YAML formatting in config files, Kubernetes manifests, and Ansible playbooks.
3.5k
30-day installs · #750
9.0k
90-day · #852
34.9k
365-day · #823
3.4k
★ GitHub stars · updated 2d ago
Runtime dependencies
GitHub topics
lint
linter
yaml
yamllint
Links
- https://github.com/adrienverge/yamllint
- GitHub: adrienverge/yamllint
- Brew formula source: Formula/y/yamllint.rb
Blurb generated by claude-haiku-4-5 on today.
Raw metadata
{
"aliases": [],
"alternatives": [
"yamlfmt",
"prettier"
],
"build_dependencies": [],
"categories": [
"linter",
"yaml-tool"
],
"caveats": null,
"conflicts_with": [],
"dependencies": [
"libyaml",
"python@3.14"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Linter for YAML files",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:41:04+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "yamllint",
"github_default_branch": "master",
"github_last_commit_at": "2026-06-18T14:46:58Z",
"github_readme_excerpt": "yamllint\n========\n\nA linter for YAML files.\n\nyamllint does not only check for syntax validity, but for weirdnesses like key\nrepetition and cosmetic problems such as lines length, trailing spaces,\nindentation, etc.\n\n.. image::\n https://github.com/adrienverge/yamllint/actions/workflows/tests.yaml/badge.svg?branch=master\n :target: https://github.com/adrienverge/yamllint/actions/workflows/tests.yaml?query=branch%3Amaster\n :alt: CI tests status\n.. image::\n https://coveralls.io/repos/github/adrienverge/yamllint/badge.svg?branch=master\n :target: https://coveralls.io/github/adrienverge/yamllint?branch=master\n :alt: Code coverage status\n.. image:: https://readthedocs.org/projects/yamllint/badge/?version=latest\n :target: https://yamllint.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation status\n\nWritten in Python.\n\nDocumentation\n-------------\n\nhttps://yamllint.readthedocs.io/\n\nOverview\n--------\n\nScreenshot\n^^^^^^^^^^\n\n.. image:: docs/screenshot.png\n :alt: yamllint screenshot\n\nInstallation\n^^^^^^^^^^^^\n\nUsing pip, the Python package manager:\n\n.. code:: bash\n\n pip install --user yamllint\n\nyamllint is also packaged for all major operating systems, see installation\nexamples (``dnf``, ``apt-get``...) `in the documentation\n\u003chttps://yamllint.readthedocs.io/en/stable/quickstart.html\u003e`_.\n\nUsage\n^^^^^\n\n.. code:: bash\n\n # Lint one or more files\n yamllint my_file.yml my_other_file.yaml ...\n\n.. code:: bash\n\n # Recursively lint all YAML files in a directory\n yamllint .\n\n.. code:: bash\n\n # Use a pre-defined lint configuration\n yamllint -d relaxed file.yaml\n\n # Use a custom lint configuration\n yamllint -c /path/to/myconfig file-to-lint.yaml\n\n.. code:: bash\n\n # Output a parsable format (for syntax checking in editors like Vim, emacs...)\n yamllint -f parsable file.yaml\n\n`Read more in the complete documentation! \u003chttps://yamllint.readthedocs.io/\u003e`__\n\nFeatures\n^^^^^^^^\n\nHere is a yamllint configuration file example:\n\n.. code:: yaml\n\n extends: default\n\n rules:\n # 80 c",
"github_repo": "adrienverge/yamllint",
"github_stars": 3410,
"github_topics": [
"lint",
"linter",
"yaml",
"yamllint"
],
"homepage": "https://github.com/adrienverge/yamllint",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 3468,
"installs_365d": 34858,
"installs_90d": 8989,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "GPL-3.0-or-later",
"llm_generated_at": "2026-06-20T23:46:49+00:00",
"llm_model": "claude-haiku-4-5",
"name": "yamllint",
"oldnames": [],
"one_liner": "Python linter for YAML files that checks syntax, style, and common mistakes like key repetition and trailing spaces.",
"optional_dependencies": [],
"rank_30d": 750,
"rank_365d": 823,
"rank_90d": 852,
"raw_hash": "d30b39567de6b36f",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/y/yamllint.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "1.38.0",
"versioned_formulae": [],
"why_use_this": "Catches both syntax errors and cosmetic YAML problems (indentation, line length, trailing whitespace, duplicate keys) in CI/CD pipelines and pre-commit hooks. Highly configurable rules and integrates well with editor plugins and linting workflows. Essential for teams enforcing consistent YAML formatting in config files, Kubernetes manifests, and Ansible playbooks."
}