# orhun/git-cliff

A highly customizable Changelog Generator that follows Conventional Commit specifications ⛰️

Repository: https://github.com/orhun/git-cliff
Canonical: https://ross.abutalabs.com/products/git-cliff
Homepage: https://git-cliff.org
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: changelog, generator, changelog-generator, commit, conventional-commits, conventional-changelog, keepachangelog, semver, rust, hacktoberfest, git-cliff, conventional-commit, git
Last push: 2026-08-22T21:56:26+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 69, longevity 100
- inputs: {"age_days": 1921, "days_push": 11, "days_rel": 129, "gap_med": 54, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12164, forks 321 (observed 2026-08-28T04:10:51.882730+00:00)

## What it is
git-cliff is a highly customizable changelog generator written in Rust that creates changelog files from Git history using Conventional Commits and regex-powered custom commit parsers. It supports templated output via configuration files and can be used as a CLI tool or as a Rust library.

## Use cases
- generate a changelog from git commit history
- create release notes following conventional commits
- automatically update CHANGELOG.md in CI
- determine next semantic version from commit messages
- customize changelog format with templates
- parse non-conventional commit messages with regex rules

## When to choose
- your project follows (or can adopt) Conventional Commits
- you want a fast, configurable changelog tool usable as CLI or Rust library
- you need CI/CD integration for automated release notes and SemVer bumping

## When to avoid
- your commit history is unstructured and you cannot add commit conventions
- you need a GUI-based changelog editor rather than a command-line tool

## Facets
- artifact type: cli-tool
- maturity: stable
- function: cli, developer-tools, documentation, parser, version-control, markdown, templating
- domain: developer-tools, version-control, documentation
- platform: cli, rust, cross-platform, python
- tags: changelog-generator, conventional-commits, keepachangelog, semver, git-history, release-notes, command-line, automation, docker, nodejs

## Member repositories
- orhun/git-cliff (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:51.882730+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:14:53.554065+00:00, confidence not recorded.
  - readme: https://github.com/orhun/git-cliff (fetched 2026-08-28T04:10:51.882730+00:00, sha f11a0a1dcaf9)
  - homepage: https://git-cliff.org (fetched 2026-08-29T08:12:04.523186+00:00, sha 1df1f2c97a1f)
  - site_page: https://git-cliff.org/docs (fetched 2026-08-29T08:12:04.532387+00:00, sha 2d5f2665d41a)
  - registry_crates: https://crates.io/api/v1/crates/git-cliff (fetched 2026-08-29T08:12:04.535600+00:00, sha c8e40525ad3e)
- Data as of 2026-08-30T08:39:29.467469+00:00.