Clone or download
Latest commit d636811 Jun 2, 2018

Lint commit messages

Demo generated with svg-term-cli

cat docs/assets/commitlint.json | svg-term --out docs/assets/commitlint.svg --frame --profile=Seti --height=20 --width=80

commitlint slack

npm latest Travis branch AppVeyor branch

  • πŸš“ Be a good commitizen
  • πŸ“¦ Share configuration via npm
  • πŸ€– Tap into conventional-changelog


Getting started

# Install commitlint cli and angular config
npm install --save-dev @commitlint/{config-conventional,cli}
# For Windows:
npm install --save-dev @commitlint/config-conventional @commitlint/cli

# Configure commitlint to use angular config
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js

To lint commits before they are created you can use the 'commitmsg' hook as described here

  "scripts": {
    "commitmsg": "commitlint -E GIT_PARAMS"

Detailed Setup instructions


  • Primary way to interact with commitlint.
  • npm install --save-dev @commitlint/cli
  • Packages: cli


  • Configuration is picked up from commitlint.config.js, .commitlintrc.js, .commitlintrc.json, or .commitlintrc.yml file or a commitlint field in package.json
  • Packages: cli, core
  • See Rules for a complete list of possible rules
  • An example configuration can be found at @commitlint/config-conventional

Shared configuration

A number of shared configurations are available to install and use with commitlint:


  • Alternative, programmatic way to interact with commitlint
  • Packages:
    • format - Format commitlint reports
    • lint - Lint a string against commitlint rules
    • load - Load shared commitlint configuration
    • read - Read commit messages from a specified range or last edit
  • See API for a complete list of methods and examples



Ideas: marionebl/commitlint#94

commitlint is considered stable and is used in various projects as development tool.

We identify ease of adoption and developer experience as fields where there is room and need for improvement. The items on the roadmap should enhance commitlint regarding those aspects.

  • Adoption: Provide reusable Travis CI integration: @commitlint/travis-cli (
  • DX: Support PR squash scenario via ahmed-taj/commitlint-bot and @commitlint/travis-cli
  • Adoption: Make ahmed-taj/commitlint-bot configurable via commitlint configuration
  • Adoption: Create commitlint init
  • DX: Extend the configuration schema to allow for additional fields (descriptions, examples, fixes) on both the rule and value level
  • DX: Incorporate an extended version of lennym/commit-template deducing a template from commitlint configuration
  • DX: Rewrite @commitlint/prompt for better usability (might involve a lot of yak-shaving)

Version Support

  • Node.js LTS >= 6
  • git >= 2

Related projects


Copyright by @marionebl. All commitlint packages are released under the MIT license.


commitlint is developed in a mono repository.

Install and run

git clone
cd commitlint
npx yarn install
npx yarn run build # run build tasks
npx yarn start # run tests, again on change

For more information on how to contribute please take a look at our contribution guide.

Publishing a release

npx yarn run clean
npx yarn install
npx yarn run build
npx yarn test
npx yarn run publish