43 releases (13 stable)

new 2.0.4 Feb 22, 2024
1.4.0 Oct 29, 2023
1.2.0 Apr 28, 2023
1.1.2 Jan 20, 2023
0.1.0-rc.21 Jul 1, 2021

#702 in Development tools

Download history 726/week @ 2023-11-02 573/week @ 2023-11-09 759/week @ 2023-11-16 1038/week @ 2023-11-23 1107/week @ 2023-11-30 1118/week @ 2023-12-07 927/week @ 2023-12-14 680/week @ 2023-12-21 973/week @ 2023-12-28 971/week @ 2024-01-04 743/week @ 2024-01-11 1248/week @ 2024-01-18 1000/week @ 2024-01-25 866/week @ 2024-02-01 1057/week @ 2024-02-08 1692/week @ 2024-02-15

4,811 downloads per month
Used in 8 crates (7 directly)

MIT/Apache

105KB
3K 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.

Contributors

Thanks goes to these wonderful people ✨

Made with contrib.rocks.

License

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

Copyright © 2021-2024, git-cliff contributors

Dependencies

~17–34MB
~463K SLoC