orhun/git-cliff

Health v2 · maintenance only

Adoption not part of the score

12164 stars · 321 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

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

cli-tool · maturity stable

cli developer-tools documentation parser version-control markdown templating developer-tools version-control documentation cli rust cross-platform python changelog-generator conventional-commits keepachangelog semver git-history release-notes command-line automation docker nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="orhun/git-cliff")