changelg

Generate a CHANGELOG from your git history. Point it at a range of Conventional Commits and it prints a clean, grouped, Markdown changelog. Zero dependencies — no Rust to install, no config file, no GitHub token, no CI integration. One command, on your machine.

changelg --release v1.2.0

## v1.2.0 (2026-06-15)

### ⚠ BREAKING CHANGES

- **auth:** existing tokens are invalidated on deploy. (6667b72)

### Features

- **api:** add cursor pagination (a1b2c3d)
- **auth:** switch to short-lived tokens (6667b72)

### Bug Fixes

- handle an empty response body (e4f5a6b)

Why

You finish a release, mean to write the changelog "later," and three weeks on you're squinting at git log trying to remember what changed. The existing tools each ask for something:

• git-cliff is excellent — but it's a Rust binary you have to install via cargo or a release download, with a config file to learn.
• standard-version is deprecated.
• release-please is powerful but wants GitHub Actions and a workflow.

changelg is the small one. If your commits roughly follow Conventional Commits, it groups them into sections and writes the Markdown. That's it.

Usage

changelg                       # changes since the latest tag → HEAD
changelg v1.2.0                # changes since v1.2.0 (→ HEAD)
changelg v1.2.0..v1.3.0        # an explicit range
changelg --release v1.3.0      # set the heading version
changelg -o CHANGELOG.md       # write to a file (otherwise: stdout)

Sections

feat → Features, fix → Bug Fixes, perf → Performance, and a ! or a BREAKING CHANGE: footer surfaces a ⚠ BREAKING CHANGES section (showing the breaking note). By default the noisier types (docs/chore/refactor/...) are hidden; --all brings them in. Commit hashes become links when an origin remote is detected.

Install

pip install changelg        # Python >= 3.8
npx changelg                # Node >= 18 (byte-for-byte port)

• PyPI: https://pypi.org/project/changelg/
• npm: https://www.npmjs.com/package/changelg
• GitHub: https://github.com/jjdoor/changelg-py · changelg (Node)

License

MIT