61 releases (26 stable)

2.8.0 Jan 24, 2025
2.7.0 Nov 20, 2024
2.6.1 Sep 27, 2024
2.4.0 Jun 26, 2024
0.1.0-rc.21 Jul 1, 2021

#2851 in Development tools

Download history 738/week @ 2024-11-24 799/week @ 2024-12-01 806/week @ 2024-12-08 988/week @ 2024-12-15 353/week @ 2024-12-22 523/week @ 2024-12-29 966/week @ 2025-01-05 685/week @ 2025-01-12 1448/week @ 2025-01-19 1526/week @ 2025-01-26 1107/week @ 2025-02-02 1133/week @ 2025-02-09 1393/week @ 2025-02-16 1080/week @ 2025-02-23 984/week @ 2025-03-02 844/week @ 2025-03-09

4,396 downloads per month
Used in 12 crates (10 directly)

MIT/Apache

220KB
6.5K SLoC




Documentation | Website

git-cliff can generate changelog files from the Git history by utilizing conventional commits as well as regex-powered custom parsers. The changelog template can be customized with a configuration file to match the desired format.

animation

Documentation

Learn how to use git-cliff from the documentation.

In The Media

Editor Support

  • git-cliff.el - Generate, update and release changelog in Emacs

Similar/Related Projects

  • git-journal - The Git Commit Message and Changelog Generation Framework
  • clog-cli - Generate beautiful changelogs from your Git commit history
  • relnotes - A tool to automatically generate release notes for your project.
  • cocogitto - A set of CLI tools for the conventional commit and semver specifications.
  • cliff-jumper - A NodeJS CLI tool that combines git-cliff and conventional-recommended-bump to semantically bump a NodeJS package and generate a git-cliff powered changelog.
  • release-plz - Release Rust packages from CI.
  • git-changelog-command-line - Generate changelog and determine next version with conventional commits.
  • git-changelog: Automatic Changelog generator using Jinja2 templates.

Contributors

Thanks goes to these wonderful people ✨

Made with contrib.rocks.

Socials


License

Licensed under either of Apache License Version 2.0 or The MIT License at your option.

Copyright © 2021-2025, git-cliff contributors

Dependencies

~24–59MB
~893K SLoC