{"id":25102,"library":"commitlint-azure-pipelines-cli","title":"commitlint-azure-pipelines-cli","description":"CLI tool to lint commits in Azure Pipelines using commitlint. Current stable version is 1.0.5 (last updated December 2022, sporadically maintained). Requires @commitlint/cli >=7.0.0 as a peer dependency. Key differentiator: zero configuration needed for Azure Pipelines CI — automatically detects the correct commit range for pull requests and branches, simplifying setup compared to manually specifying commit ranges with commitlint directly.","status":"active","version":"1.0.5","language":"javascript","source_language":"en","source_url":"https://github.com/princjef/commitlint-azure-pipelines-cli","tags":["javascript","commitlint","cli","azure","pipelines","devops","ci","typescript"],"install":[{"cmd":"npm install commitlint-azure-pipelines-cli","lang":"bash","label":"npm"},{"cmd":"yarn add commitlint-azure-pipelines-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add commitlint-azure-pipelines-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; provides the commitlint engine that performs the actual linting","package":"@commitlint/cli","optional":false}],"imports":[{"note":"The package provides a CLI binary, not a JavaScript API. Use the path or run via npx.","wrong":"npx commitlint-azure-pipelines","symbol":"bin/commitlint-azure-pipelines","correct":"./node_modules/.bin/commitlint-azure-pipelines"},{"note":"Though types are shipped, the package is primarily a CLI. The module export is undocumented and may be unstable.","wrong":"const commitlintAzurePipelines = require('commitlint-azure-pipelines-cli')","symbol":"commitlintAzurePipelines (if imported as module)","correct":"import commitlintAzurePipelines from 'commitlint-azure-pipelines-cli'"},{"note":"The package provides a CommonJS entry; named export 'run' is available, but not a default export. ESM usage may require bundler interop.","wrong":"import { run } from 'commitlint-azure-pipelines-cli';","symbol":"run function (if used programmatically)","correct":"const { run } = require('commitlint-azure-pipelines-cli'); run();"}],"quickstart":{"code":"# Install dependencies\nnpm install --save-dev @commitlint/cli commitlint-azure-pipelines-cli\n\n# Add to azure-pipelines.yml:\n# steps:\n#   - script: ./node_modules/.bin/commitlint-azure-pipelines\n","lang":"javascript","description":"Installs and runs commitlint for Azure Pipelines with zero config. Detects commit range based on PR or branch."},"warnings":[{"fix":"Ensure @commitlint/cli is installed and meets the minimum version: npm install @commitlint/cli@latest","message":"Requires @commitlint/cli >=7.0.0 as a peer dependency; commitlint older than 7 will not work.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Run the script from the repository root or use a full path.","message":"The CLI binary must be run from the project root directory (where node_modules/.bin is accessible). Running from subdirectories will fail.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade Node.js to version 10 or higher.","message":"Only tested against Node.js 10.x and up; may fail on older versions.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Create a valid .commitlintrc.json (or .commitlintrc.js) at the repository root. Example: { \"extends\": [\"@commitlint/config-conventional\"] }","cause":"commitlint configuration file is malformed or missing.","error":"Error: config is not valid JSON: /home/vsts/work/1/s/.commitlintrc.json"},{"fix":"Run npm install --save-dev @commitlint/cli to install commitlint.","cause":"commitlint is not installed (missing peer dependency).","error":"/usr/local/bin/commitlint-azure-pipelines: line 1: ./node_modules/.bin/commitlint: No such file or directory"},{"fix":"Install the full commitlint package: npm install --save-dev @commitlint/cli @commitlint/core","cause":"Missing commitlint dependency or incorrect version.","error":"Cannot find module '@commitlint/format'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}