# conventional-commits-parser

> Parse raw conventional commits.

Latest version **7.1.2** (published 2026-07-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install conventional-commits-parser
pnpm add conventional-commits-parser
yarn add conventional-commits-parser
bun add conventional-commits-parser
```

Provides the command `conventional-commits-parser`.

## Health

**Score 63/100 (C)** — status: active.

Positive: has types package; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 7.1.2 |
| Published | 2026-07-31 |
| First published | 2015-03-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/conventional-commits-parser) |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 2 |
| Unpacked size | 67.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8511 |
| Author | Steve Mao |
| Maintainers | bcoe, oss-bot, dangreen, stevemao |
| Keywords | conventional-commits-parser, changelog, conventional, parser, parsing, logs |

## Links

- npm: https://www.npmjs.com/package/conventional-commits-parser
- Repository: https://github.com/conventional-changelog/conventional-changelog
- Homepage: https://conventional-changelog.js.org/commits-parser/
- Issues: https://github.com/conventional-changelog/conventional-changelog/issues
- npm.io page: https://npm.io/package/conventional-commits-parser

## Dependencies (2)

- [argue-cli](https://npm.io/package/argue-cli.md) ^3.1.0
- [@simple-libs/stream-utils](https://npm.io/package/@simple-libs/stream-utils.md) ^2.0.0

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 7.1.2 (latest) — 2026-07-31
- 3.2.0 (next) — 2020-11-05
- 7.1.1 — 2026-07-26
- 7.1.0 — 2026-07-09
- 7.0.1 — 2026-07-04
- 7.0.0 — 2026-06-26
- 6.4.0 — 2026-03-29
- 6.3.0 — 2026-03-01
- 6.2.1 — 2025-10-20
- 6.2.0 — 2025-06-09
- 6.1.0 — 2025-02-16
- 6.0.0 — 2024-05-03
- 5.0.0 — 2023-08-26
- 4.0.0 — 2023-06-06
- 3.2.4 — 2021-12-29
- … 53 more at https://npm.io/package/conventional-commits-parser/versions

## README

# conventional-commits-parser

[![ESM-only package][package]][package-url]
[![NPM version][npm]][npm-url]
[![Node version][node]][node-url]
[![Dependencies status][deps]][deps-url]
[![Install size][size]][size-url]
[![Build status][build]][build-url]
[![Coverage status][coverage]][coverage-url]

[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
[package-url]: https://nodejs.org/api/esm.html

[npm]: https://img.shields.io/npm/v/conventional-commits-parser.svg
[npm-url]: https://npmjs.com/package/conventional-commits-parser

[node]: https://img.shields.io/node/v/conventional-commits-parser.svg
[node-url]: https://nodejs.org

[deps]: https://img.shields.io/librariesio/release/npm/conventional-commits-parser
[deps-url]: https://libraries.io/npm/conventional-commits-parser

[size]: https://packagephobia.com/badge?p=conventional-commits-parser
[size-url]: https://packagephobia.com/result?p=conventional-commits-parser

[build]: https://img.shields.io/github/actions/workflow/status/conventional-changelog/conventional-changelog/tests.yaml?branch=master
[build-url]: https://github.com/conventional-changelog/conventional-changelog/actions

[coverage]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master

Parse raw conventional commits.

## Install

```bash
# pnpm
pnpm add conventional-commits-parser
# yarn
yarn add conventional-commits-parser
# npm
npm i conventional-commits-parser
```

## Usage

```js
import { CommitParser } from 'conventional-commits-parser'

const parser = new CommitParser()
const commit = parser.parse(
  'feat(scope): broadcast $destroy event on scope destruction\nCloses #1'
)

console.log(commit)
/* {
  type: 'feat',
  scope: 'scope',
  subject: 'broadcast $destroy event on scope destruction',
  header: 'feat(scope): broadcast $destroy event on scope destruction',
  footer: 'Closes #1',
  references: [{
    action: 'Closes',
    issue: '1',
    raw: '#1',
    prefix: '#',
    ...
  }],
  ...
} */
```

## Documentation

For streams and async iterables helpers, parser options, and CLI usage, visit the [documentation website](https://conventional-changelog.js.org/commits-parser/).

## License

MIT © [Steve Mao](https://github.com/stevemao)

---
_Source: https://npm.io/package/conventional-commits-parser · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._