---
id: git-cliff
version: "2.13.1"
license: unclear
license_treatment: unclear
maintenance: active
---

# git-cliff

License: unclear · Maintenance: active · Downloads: 216.7K/mo

## What it is and what it does

git-cliff is a changelog generator that reads your Git commit history and produces formatted changelog files. It parses commits using conventional commit conventions by default, but also supports regex-powered custom parsers to extract structured information from your commit messages. The generated changelog is templated and configurable, so you can match your project's desired format and structure.

The package is distributed as a compiled Rust binary wrapped for Python, making it a command-line tool rather than a library for programmatic use. It's designed for release management workflows where you want to automatically generate release notes from your commit history without manual curation.

Use it for:

- Automate changelog generation during CI/CD release pipelines to keep release notes in sync with commits.
- Parse monorepo commits with custom regex patterns to generate separate changelogs per package.
- Generate formatted release notes from conventional commits to enforce consistent commit message standards.
- Create templated changelogs that group commits by type (features, fixes, breaking changes) automatically.
- Integrate changelog generation into your release workflow to reduce manual documentation effort.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

git-cliff generates changelog files from Git history using conventional commits and customizable regex parsers, with templating to match your desired format.

Yes. The package is actively maintained, has no known vulnerabilities, is permissively licensed, and solves a real problem in release automation. The medium install friction (platform-specific wheels) is a minor trade-off for a compiled tool. Install it if you need automated changelog generation from Git history.

## Install

pip install git-cliff
uv add git-cliff
poetry add git-cliff

## Installing git-cliff

Before you install: Medium install friction due to platform-specific wheels (compiled Rust binary), but the package is actively maintained with a recent release and no known vulnerabilities.

License in practice: Licensed under Apache License 2.0 or MIT at your option—both permissive licenses with no restrictions on commercial or private use.

Quickstart:

pip install git-cliff

git-cliff --init
git-cliff

Requires Git to be installed and available in PATH; operates on the current Git repository.

Verify before relying:

- Whether the Python package is a wrapper around the Rust binary or a pure Python implementation.
- Whether custom parsers support all regex features or have limitations.
- Performance characteristics on repositories with very large commit histories.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 216.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

changelog generator from git commits, conventional commits changelog, automated release notes, git history to markdown, changelog templating tool, commit-based changelog, release note automation, changelog-generation, release-automation, git-tooling

[View on SkillFed](https://skillfed.io/packages/git-cliff) · [View on PyPI](https://pypi.org/project/git-cliff/)