# @monorepo-utils/collect-changelog

> Collect CHANGELOG from tags.

Latest version **2.11.0** (published 2025-05-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install @monorepo-utils/collect-changelog
pnpm add @monorepo-utils/collect-changelog
yarn add @monorepo-utils/collect-changelog
bun add @monorepo-utils/collect-changelog
```

Provides the command `monorepo-utils-collect-changelog`.

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.11.0 |
| Published | 2025-05-12 |
| First published | 2018-07-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 24.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 180 |
| Author | azu |
| Maintainers | azu |
| Keywords | changelog, lerna, monorepo |

## Links

- npm: https://www.npmjs.com/package/@monorepo-utils/collect-changelog
- Repository: https://github.com/azu/monorepo-utils
- Issues: https://github.com/azu/monorepo-utils/issues
- npm.io page: https://npm.io/package/@monorepo-utils/collect-changelog

## Dependencies (6)

- [meow](https://npm.io/package/meow.md) ^7.1.1
- [upath](https://npm.io/package/upath.md) ^2.0.1
- [handlebars](https://npm.io/package/handlebars.md) ^4.0.12
- [cclog-parser](https://npm.io/package/cclog-parser.md) ^1.1.1
- [changelog-parser](https://npm.io/package/changelog-parser.md) ^2.6.0
- [@monorepo-utils/package-utils](https://npm.io/package/@monorepo-utils/package-utils.md) ^2.11.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 2.11.0 (latest) — 2025-05-12
- 2.10.4 — 2023-11-09
- 2.10.3 — 2023-11-09
- 2.10.2 — 2023-07-07
- 2.9.0 — 2022-12-02
- 2.8.1 — 2022-05-16
- 2.8.0 — 2022-05-16
- 2.7.0 — 2021-10-20
- 2.4.4 — 2021-01-15
- 2.3.1 — 2020-10-22
- 2.3.0 — 2020-08-30
- 2.2.0 — 2020-04-28
- 2.1.1 — 2019-01-22
- 2.0.2 — 2019-01-22
- 2.0.1 — 2018-08-07
- … 3 more at https://npm.io/package/@monorepo-utils/collect-changelog/versions

## README

# @monorepo-utils/collect-changelog

Collect CHANGELOG from tags.

## Feature

- Support independent mode
    - Currently it support [Independent mode](https://github.com/lerna/lerna#independent-mode---independent) only
- Get CHANGELOG from each package's `CHANGELOG.md`

## Install

Install with [npm](https://www.npmjs.com/):

    npm install @monorepo-utils/collect-changelog

## Usage

    Usage
      $ collect-changelog-from-tag [option] "tag@version"

    Options
      --changelog the file path of CHANGELOG.md
      --directory the root directory of monorepo
      --template  handlebars template path
      --name set package name if it not defined

    Examples
      $ collect-changelog-from-tag --directory /path/to/monorepo-project/ "tag@version"
      # current directory is project root for independent mode
      $ collect-changelog-from-tag "tag@version"
      # get changelog content from specific CHANGELOG.md for fixed mode
      $ collect-changelog-from-tag --changelog ./CHANGELOG.md "tag@version"
      

## Example

    $ monorepo-utils-collect-changelog "textlint@8.0.0"
    
    ## textlint@8.0.0
    
    ### fixes
    
    - **babel:** ignore lib directory ([12e581d](https://github.com/textlint/textlint/commit/12e581d))
    - **fixer:** fix thrown error when empty result. (#274) ([7013cee](https://github.com/textlint/textlint/commit/7013cee)), closes [#274](https://github.com/textlint/textlint/issues/274)
    - **textilnt:** fix JSDoc ([8a417e0](https://github.com/textlint/textlint/commit/8a417e0))
    
    ### features
    
    - **packages:** import textlint-plugin-text ([1b7a571](https://github.com/textlint/textlint/commit/1b7a571))
    - **textlint:** update built-in textlint-plugin-markdown@^2 (#282) ([448fef9](https://github.com/textlint/textlint/commit/448fef9))
    
    ### breakingChanges
    
    - **textlint:** markdown-to-ast@4 includes some breaking change

Get all changelog at point.

    $ lerna publish --skip-npm
    # tag each packages
    $ git tag --points-at HEAD | xargs -I{} monorepo-utils-collect-changelog {}
    # get CHANGELOG from each packages

## Author

- [github/azu](https://github.com/azu)
- [twitter/azu_re](https://twitter.com/azu_re)

## License

MIT © azu

---
_Source: https://npm.io/package/@monorepo-utils/collect-changelog · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._