CHANGELOG.md

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

20.5.0 (2026-03-15)

Bug Fixes

• cli: validate that --cwd directory exists before execution (#4658) (cf80f75), closes #4595

20.4.4 (2026-03-12)

Note: Version bump only for package @commitlint/cli

20.4.3 (2026-03-03)

Bug Fixes

• footer parser does not escape special chars for regex #4560 (#4634) (8ff7c7f)

20.4.2 (2026-02-19)

Note: Version bump only for package @commitlint/cli

20.4.1 (2026-02-02)

Note: Version bump only for package @commitlint/cli

20.4.0 (2026-01-30)

Features

• upgrade conventional commit packages #4082 (#4597) (3aaf0a6)

20.3.1 (2026-01-08)

Note: Version bump only for package @commitlint/cli

20.3.0 (2026-01-01)

Note: Version bump only for package @commitlint/cli

20.2.0 (2025-12-05)

Note: Version bump only for package @commitlint/cli

20.1.0 (2025-09-30)

Note: Version bump only for package @commitlint/cli

20.0.0 (2025-09-25)

Note: Version bump only for package @commitlint/cli

19.8.1 (2025-05-08)

Bug Fixes

• update dependency tinyexec to v1 (#4332) (e49449f)

19.8.0 (2025-03-07)

Performance Improvements

• use node: prefix to bypass require.cache call for builtins (#4302) (0cd8f41)

19.7.1 (2025-02-02)

Note: Version bump only for package @commitlint/cli

19.6.1 (2024-12-15)

Note: Version bump only for package @commitlint/cli

19.6.0 (2024-11-19)

Note: Version bump only for package @commitlint/cli

19.5.0 (2024-09-11)

Features

• cli: use special errorCode for missing rules/config #4142 (#4143) (d7070d8)

19.4.1 (2024-08-28)

Note: Version bump only for package @commitlint/cli

19.4.0 (2024-08-07)

Features

• support command line options from a file (#4109) (a20e890)
• support linting from the last tag (#4110) (4b204ec)

19.3.0 (2024-04-23)

Note: Version bump only for package @commitlint/cli

19.2.2 (2024-04-14)

Note: Version bump only for package @commitlint/cli

19.2.1 (2024-03-19)

Note: Version bump only for package @commitlint/cli

19.2.0 (2024-03-15)

Features

• cli: introduce new --last flag, to stop recommending HEAD~1 (#3916) (99f4f3f)

19.1.0 (2024-03-12)

Note: Version bump only for package @commitlint/cli

19.0.3 (2024-02-28)

Note: Version bump only for package @commitlint/cli

19.0.2 (2024-02-28)

Note: Version bump only for package @commitlint/cli

19.0.1 (2024-02-27)

Bug Fixes

• drop resolve-from, resolve-global and import-fresh, resolve global packages correctly (#3939) (8793c63), closes #3938

19.0.0 (2024-02-27)

• feat!: migrate to pure ESM (#3850) (3423735), closes #3850

Reverts

• Revert "chore!: minimum node version v20" (2816783)

BREAKING CHANGES

• migrate to pure ESM

• feat: migrate to pure ESM

• chore: update snapshot

• fix: load parserPreset with another await

• test: migrate to vitest

• test: remove no replacement --runInBand test-ci script

• chore: fix code reviews

• refactor(load): rewrite resolve logic

• fix(config-nx-scopes): fix syntax error

• feat(resolve-extends): add resolveFrom and loadParserPreset

• feat(load): use resolveFrom and loadParserPreset from resolve-extends

• test: include only @commitlint/* packages src in coverage

• test: explicit import vitest utilities

• test: remove @jest/globals from dependencies

• fix(resolve-extends): resolveFrom output should be platform aware

• test: restore NO_COLOR to test script

• chore: fix linting issues

• fix: should use fileURLToPath instead of pathname for Windows compatibility

• Apply suggestions from code review

• fix: should reuse cli instead call yargs()

• feat(cli): set terminalWidth as wrap to avoid work break on help

• Update .eslintrc.cjs

• feat: migrate @commitlint/config-conventional to pure ESM

18.6.1 (2024-02-13)

Note: Version bump only for package @commitlint/cli

18.6.0 (2024-01-25)

Note: Version bump only for package @commitlint/cli

18.5.0 (2024-01-22)

Features

• cli: print-config now can be configured to print a json in stdout (#3863) (6381a2d), closes #3819

18.4.4 (2024-01-04)

Note: Version bump only for package @commitlint/cli

18.4.3 (2023-11-21)

Note: Version bump only for package @commitlint/cli

18.4.2 (2023-11-16)

Note: Version bump only for package @commitlint/cli

18.4.1 (2023-11-12)

Note: Version bump only for package @commitlint/cli

18.4.0 (2023-11-10)

Note: Version bump only for package @commitlint/cli

18.2.0 (2023-10-26)

Note: Version bump only for package @commitlint/cli

18.1.0 (2023-10-25)

Note: Version bump only for package @commitlint/cli

18.0.0 (2023-10-20)

• chore!: minimum node version v18 (#3644) (5b4aeaf), closes #3644

BREAKING CHANGES

• drop node v14 and v16 support

• chore: remove unused types

• docs: prepare node update and new release

• chore!: minimum TS version v5

• drop TS v4 support

• ci: remove node v14/16 checks

• chore: adjust node types to minimal supported version

• chore!: further major versions of other deps

• upgrade conventional-changelog-conventionalcommits, conventional-commits-parser, conventional-changelog-atom,

• docs: simplify releases and remove roadmap

17.8.1 (2023-10-20)

Note: Version bump only for package @commitlint/cli

17.8.0 (2023-10-14)

Note: Version bump only for package @commitlint/cli

17.7.2 (2023-09-28)

Note: Version bump only for package @commitlint/cli

17.7.1 (2023-08-10)

Note: Version bump only for package @commitlint/cli

17.7.0 (2023-08-09)

Note: Version bump only for package @commitlint/cli

17.6.7 (2023-07-19)

Note: Version bump only for package @commitlint/cli

17.6.6 (2023-06-24)

Note: Version bump only for package @commitlint/cli

17.6.5 (2023-05-30)

Note: Version bump only for package @commitlint/cli

17.6.3 (2023-05-04)

Note: Version bump only for package @commitlint/cli

17.6.1 (2023-04-14)

Note: Version bump only for package @commitlint/cli

17.6.0 (2023-04-13)

Note: Version bump only for package @commitlint/cli

17.5.1 (2023-03-28)

Note: Version bump only for package @commitlint/cli

17.5.0 (2023-03-22)

Note: Version bump only for package @commitlint/cli

17.4.4 (2023-02-17)

Note: Version bump only for package @commitlint/cli

17.4.3 (2023-02-13)

Note: Version bump only for package @commitlint/cli

17.4.2 (2023-01-12)

Note: Version bump only for package @commitlint/cli

17.4.1 (2023-01-09)

Note: Version bump only for package @commitlint/cli

17.4.0 (2023-01-04)

Bug Fixes

• update dependency fs-extra to v11 (#3460) (a437923)

17.3.0 (2022-11-21)

Note: Version bump only for package @commitlint/cli

17.2.0 (2022-10-31)

Features

• cli: add strict mode (#3384) (#3385) (fdff2be)

17.1.2 (2022-08-29)

Note: Version bump only for package @commitlint/cli

17.1.1 (2022-08-27)

Note: Version bump only for package @commitlint/cli

17.1.0 (2022-08-27)

Features

• commitlint: add additional git log args (#3334) (229c65b)

17.0.3 (2022-06-25)

Note: Version bump only for package @commitlint/cli

17.0.2 (2022-06-01)

Note: Version bump only for package @commitlint/cli

17.0.1 (2022-05-25)

Bug Fixes

• cli: use core.commentChar from git config with --edit flag (#3191) (e5fee05), closes #3190 #3190 #3190

17.0.0 (2022-05-16)

• chore!: minimum node version v14 (#3128) (ac5f9b4), closes #3128

BREAKING CHANGES

• drop node v12 support

• chore: rename circleci windows job

node version is not defned by the name anyways (i think)

16.3.0 (2022-05-14)

Note: Version bump only for package @commitlint/cli

16.2.4 (2022-04-28)

Note: Version bump only for package @commitlint/cli

16.2.3 (2022-03-16)

Note: Version bump only for package @commitlint/cli

16.2.1 (2022-02-13)

Note: Version bump only for package @commitlint/cli

16.1.0 (2022-01-20)

Note: Version bump only for package @commitlint/cli

16.0.3 (2022-01-19)

Note: Version bump only for package @commitlint/cli

16.0.2 (2022-01-09)

Note: Version bump only for package @commitlint/cli

16.0.1 (2021-12-28)

Note: Version bump only for package @commitlint/cli

16.0.0 (2021-12-26)

Features

• config validation (#2412) (c717202), closes #327

15.0.0 (2021-11-17)

Features

• simplify config resolution (#2398) (8a8384f), closes #327

14.1.0 (2021-11-01)

Note: Version bump only for package @commitlint/cli

14.0.0 (2021-10-26)

Note: Version bump only for package @commitlint/cli

13.2.1 (2021-10-09)

Note: Version bump only for package @commitlint/cli

13.2.0 (2021-09-28)

Note: Version bump only for package @commitlint/cli

13.1.0 (2021-07-24)

Bug Fixes

• cli: remove hard coded comment char with linting COMMIT_EDIT_MSG (#2618) (5badf6d), closes #2351

13.0.0 (2021-05-24)

• chore!: remove node 10 support (#2596) (4db4ba1), closes #2596

BREAKING CHANGES

• minimum node version is 12

12.1.3 (2021-05-12)

Bug Fixes

• update dependency fs-extra to v10 (#2575) (d47d2b5)
• update dependency yargs to v17 (#2574) (81c38dd)

12.1.2 (2021-04-29)

Note: Version bump only for package @commitlint/cli

12.1.1 (2021-04-02)

Note: Version bump only for package @commitlint/cli

12.1.0 (2021-03-06)

Note: Version bump only for package @commitlint/cli

12.0.1 (2021-02-23)

Note: Version bump only for package @commitlint/cli

12.0.0 (2021-01-18)

Bug Fixes

• update dependency execa to v5 (#2341) (f349df9)
• update dependency yargs to v16 (204f36d)

Features

• cli: implement print-config cli flag (#2391) (8626883)
• load: allow specifying helpUrl via config (#2180) (d6795a3)

11.0.0 (2020-09-05)

Bug Fixes

• cli: remove default value from edit option #2065 (3d4116d)

10.0.0 (2020-08-16)

Bug Fixes

• update dependency execa to v4 (#1936) (8efb441)

• update dependency fs-extra to v9 (#1018) (2df49fa)

• update dependency get-stdin to v8 (#1938) (f94a5c8)

• refactor!: drop support for node 8 (#1999) (751f39f), closes #1999

BREAKING CHANGES

• remove node 8 from circle-ci checks

also remove node 13 because we do not support experimental versions

• docs: update node v10 to latest LTS 10 version

Co-authored-by: Cedric van Putten me@bycedric.com

Co-authored-by: Cedric van Putten me@bycedric.com

9.1.2 (2020-07-13)

Note: Version bump only for package @commitlint/cli

9.1.1 (2020-06-30)

Note: Version bump only for package @commitlint/cli

9.1.0 (2020-06-21)

Bug Fixes

• update dependency chalk to v4 (#1275) (a5d8fa1)
• update dependency regenerator-runtime to v0.13.5 (#1017) (9c4fdf1)

9.0.1 (2020-05-26)

Bug Fixes

• add missing @babel/runtime dep #1738 (#1754) (09afcd6)

9.0.0 (2020-05-21)

Bug Fixes

• cli: add missing regenerator-runtime to dependencies (#919) (ee5eac9)
• #840 add caret to lodash versions (#843) (ffc0bac)

8.3.5 (2020-01-15)

Note: Version bump only for package @commitlint/cli

8.3.4 (2020-01-03)

Note: Version bump only for package @commitlint/cli

8.3.1 (2019-10-16)

Note: Version bump only for package @commitlint/cli

8.3.0 (2019-10-16)

Features

• cli: add helpurl flag (#789) (75cef4e)

8.2.0 (2019-09-16)

Bug Fixes

• pass defaultIgnores from configuration in @commitlint/cli (#771) (a259014)

8.1.0 (2019-07-15)

Bug Fixes

• pass ignores from configuration in @commitlint/cli (#668) (da99aaa)

7.6.1 (2019-05-09)

Note: Version bump only for package @commitlint/cli

7.6.0 (2019-05-06)

Bug Fixes

• avoid excessive help text #606 (#637) (8f3c3b1)

Features

• adds support for plugins (#228) (#588) (cea4564)

7.5.2 (2019-02-11)

Bug Fixes

• cli: replace old links with new organisation links (#578) (4075903)

7.5.1 (2019-02-09)

Note: Version bump only for package @commitlint/cli

7.5.0 (2019-01-31)

Bug Fixes

• cli: avoid linebreak in empty input (#523) (3141882)
• all broken website references (#564) (82eeb5a)
• cleanup message for input with no config (#519) (7d9e760)
• replace all repository references with conventional changelog (#561) (6c3afcd)
• replace all website references with conventional changelog (#563) (6b86fb1)

7.4.0 (2019-01-27)

Note: Version bump only for package @commitlint/cli

7.3.2 (2019-01-15)

Note: Version bump only for package @commitlint/cli

7.3.1 (2019-01-11)

Note: Version bump only for package @commitlint/cli

7.3.0 (2019-01-11)

Bug Fixes

• add fallback with husky git params to deprecation handling (#498) (5a34b8c)
• avoid truncated output on macOS (#503) (3192368)
• respect String.protoype.repeat API contract (f27e7ac)
• update to security-patched dependency versions (97c033b)
• use correct label for failing empty subjects (#481) (2e7e34d), closes #476

Features

• check stage before entering prompt (#495) (3b3667a), closes #51 #51
• warn on empty config (#491) (b6bd36e), closes #107 #107

7.2.1 (2018-10-11)

Bug Fixes

• improve format module resolving (#464) (baed8b1)

7.2.0 (2018-10-05)

Features

• cli: add format option for report output (1ecf097)

7.1.2 (2018-09-04)

Note: Version bump only for package @commitlint/cli

7.1.0 (2018-08-29)

Note: Version bump only for package @commitlint/cli

6.2.0 (2018-05-01)

Features

• print commit message when the message is invalid (86c34f1), closes #222

6.1.1 (2018-02-22)

Note: Version bump only for package @commitlint/cli

6.1.0 (2018-02-03)

Features

• add "--config" option (#261) (2c03ec6)

6.0.5 (2018-01-31)

Note: Version bump only for package @commitlint/cli

6.0.4 (2018-01-31)

Note: Version bump only for package @commitlint/cli

6.0.3 (2018-01-31)

Note: Version bump only for package @commitlint/cli

6.0.2 (2018-01-12)

Note: Version bump only for package @commitlint/cli

6.0.1 (2018-01-09)

Note: Version bump only for package @commitlint/cli

6.0.0 (2018-01-09)

Bug Fixes

• correctly resolve parserOpts #115 #95 (1353dd5)

5.2.6 (2017-12-21)

Note: Version bump only for package @commitlint/cli

5.2.5 (2017-12-08)

Note: Version bump only for package @commitlint/cli

5.2.4 (2017-12-08)

Note: Version bump only for package @commitlint/cli

5.2.3 (2017-12-05)

Bug Fixes

• cli: add support for GIT_PARAMS on windows (c62bd41), closes #103 #175

5.2.0 (2017-11-30)

Note: Version bump only for package @commitlint/cli

5.1.1 (2017-11-24)

Note: Version bump only for package @commitlint/cli

5.1.0 (2017-11-24)

Bug Fixes

• update dependency concurrently to v3.5.1 (#147) (a809d0f)

Features

• travis-cli: add reusable travis command line interface (3e6e6a8)

5.0.1 (2017-11-19)

Note: Version bump only for package @commitlint/cli

4.3.0 (2017-11-08)

Note: Version bump only for package @commitlint/cli

4.2.2 (2017-10-26)

Note: Version bump only for package @commitlint/cli

4.2.1 (2017-10-18)

Bug Fixes

• nicer error messages (#93) (dcfad61)
• core: consider config outside of current git repo (f7234b6)

4.2.0 (2017-10-14)

Features

• edit flag now accepts the path to the commit file (c881433), closes #40

4.1.1 (2017-10-09)

Note: Version bump only for package @commitlint/cli

4.1.0 (2017-10-05)

Note: Version bump only for package @commitlint/cli

4.0.0 (2017-10-04)

Features

• enable alternative config formats (#83) (91968b8), closes #73

BREAKING CHANGES

• discontinue support of conventional-changelog-lintrc

• test: make git setup reliable

3.2.0 (2017-09-05)

Features

• add preset parser (5cd2335)

3.1.3 (2017-08-21)

Bug Fixes

• core: determine git root correctly in sub directories (#64) (d594ec4), closes #62

3.1.2 (2017-08-07)

3.1.1 (2017-08-07)

3.0.4 (2017-08-04)

Bug Fixes

• core: correct type validation message (09c2b26)

3.0.3 (2017-07-16)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.1.3 (2017-08-21)

Bug Fixes

• core: determine git root correctly in sub directories (#64) (d594ec4), closes #62

3.1.2 (2017-08-07)

3.1.1 (2017-08-07)

3.0.4 (2017-08-04)

Bug Fixes

• core: correct type validation message (09c2b26)

3.0.3 (2017-07-16)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.1.2 (2017-08-07)

3.1.1 (2017-08-07)

3.0.4 (2017-08-04)

Bug Fixes

• core: correct type validation message (09c2b26)

3.0.3 (2017-07-16)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.0.4 (2017-08-04)

Bug Fixes

• core: correct type validation message (09c2b26)

3.0.3 (2017-07-16)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.0.3 (2017-07-16)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.0.2 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.0.1 (2017-07-11)

Bug Fixes

• cli: remove destructuring for node 4 support (fe8caff)
• ensure node4 compat (bfeb653)

3.0.1 (2017-07-11)

3.0.0 (2017-07-10)

Bug Fixes

• cli: remove destructuring for node 4 support (94437e8)
• ensure node4 compat (a5e658a)

3.0.0 (2017-07-10)

Bug Fixes

• cli: remove destructuring for node 4 support (94437e8)
• ensure node4 compat (a5e658a)