git-cliff
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Git to be installed and available in PATH; operates on the current Git repository.
- 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 · maintenance · safety
(unclear) — Licensed under Apache License 2.0 or MIT at your option—both permissive licenses with no restrictions on commercial or private use.
last release 2026-04-26 (110 days) · last repo commit 2026-08-04 · 12,122 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 216,743 downloads/mo, #9,372 on PyPI
Alternatives
Verify before relying
pip install git-cliff
git-cliff --init
git-cliff- 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.
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 on this page. Verify before relying on it.
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
git-cliff on PyPI
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.
Requires Git to be installed and available in PATH; operates on the current Git repository.
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-cliffVerify 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 the current Python release >=3.7 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 110 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 216,743 / month, #9,372 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersProgramming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyProgramming Language :: RustTopic :: Software Development |
Evidence: git_cliff-2.13.1-py3-none-macosx_10_12_x86_64.whl; git_cliff-2.13.1-py3-none-macosx_11_0_arm64.whl; git_cliff-2.13.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; git_cliff-2.13.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; git_cliff-2.13.1-py3-none-manylinux_2_28_aarch64.whl; git_cliff-2.13.1-py3-none-manylinux_2_5_i686.manylinux1_i686.whl; git_cliff-2.13.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl; git_cliff-2.13.1-py3-none-musllinux_1_2_aarch64.whl; git_cliff-2.13.1-py3-none-musllinux_1_2_i686.whl; git_cliff-2.13.1-py3-none-musllinux_1_2_x86_64.whl; git_cliff-2.13.1-py3-none-win32.whl; git_cliff-2.13.1-py3-none-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “changelog generator from git commits”
- git-cliffgit-cliff generates changelog files from Git history using…
- git-changelogGenerates changelogs automatically from git commit history using…
- gitchangelogGenerates a formatted changelog from git commit history, filtering…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also git-changelog · gitchangelog · conventional-pre-commit · commitizen · commitlint · antsibull-changelog · commit-check · towncrier · sphinxcontrib-log-cabinet · python-semantic-release