{"id":13461740,"url":"https://github.com/orhun/git-cliff","last_synced_at":"2025-05-13T11:06:52.016Z","repository":{"id":37754129,"uuid":"372193147","full_name":"orhun/git-cliff","owner":"orhun","description":"A highly customizable Changelog Generator that follows Conventional Commit specifications ⛰️ ","archived":false,"fork":false,"pushed_at":"2025-05-01T22:54:44.000Z","size":15986,"stargazers_count":10027,"open_issues_count":77,"forks_count":220,"subscribers_count":37,"default_branch":"main","last_synced_at":"2025-05-13T11:06:28.730Z","etag":null,"topics":["changelog","changelog-generator","commit","conventional-changelog","conventional-commit","conventional-commits","generator","git","git-cliff","hacktoberfest","keepachangelog","rust","semver"],"latest_commit_sha":null,"homepage":"https://git-cliff.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/orhun.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"orhun","patreon":"orhunp","buy_me_a_coffee":"orhun"}},"created_at":"2021-05-30T11:11:58.000Z","updated_at":"2025-05-13T01:39:09.000Z","dependencies_parsed_at":"2023-10-14T23:11:53.028Z","dependency_job_id":"7518053d-29f1-418a-b292-aee3119b4010","html_url":"https://github.com/orhun/git-cliff","commit_stats":{"total_commits":1224,"total_committers":92,"mean_commits":"13.304347826086957","dds":0.3586601307189542,"last_synced_commit":"d0848ff04099a287157fbd22935f870e0636139d"},"previous_names":[],"tags_count":119,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgit-cliff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgit-cliff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgit-cliff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgit-cliff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orhun","download_url":"https://codeload.github.com/orhun/git-cliff/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253929364,"owners_count":21985802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["changelog","changelog-generator","commit","conventional-changelog","conventional-commit","conventional-commits","generator","git","git-cliff","hacktoberfest","keepachangelog","rust","semver"],"created_at":"2024-07-31T11:00:55.611Z","updated_at":"2025-05-13T11:06:51.995Z","avatar_url":"https://github.com/orhun.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://git-cliff.org\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/orhun/git-cliff/main/website/static/img/git-cliff-logo.png\" width=\"300\"\u003e\u003c/a\u003e\u003c!-- \u003c/a\u003e being on the same line as the \u003cimg\u003e tag is intentional! --\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/orhun/git-cliff/releases\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/v/release/orhun/git-cliff?style=flat\u0026labelColor=1C2C2E\u0026color=C96329\u0026logo=GitHub\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://crates.io/crates/git-cliff/\"\u003e\n        \u003cimg src=\"https://img.shields.io/crates/v/git-cliff?style=flat\u0026labelColor=1C2C2E\u0026color=C96329\u0026logo=Rust\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://codecov.io/gh/orhun/git-cliff\"\u003e\n        \u003cimg src=\"https://img.shields.io/codecov/c/gh/orhun/git-cliff?style=flat\u0026labelColor=1C2C2E\u0026color=C96329\u0026logo=Codecov\u0026logoColor=white\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/orhun/git-cliff/actions?query=workflow%3A%22Continuous+Integration%22\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/git-cliff/ci.yml?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=GitHub%20Actions\u0026logoColor=BEC5C9\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/orhun/git-cliff/actions?query=workflow%3A%22Continuous+Deployment%22\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/git-cliff/cd.yml?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=GitHub%20Actions\u0026logoColor=BEC5C9\u0026label=deploy\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://hub.docker.com/r/orhunp/git-cliff\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/orhun/git-cliff/docker.yml?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026label=docker\u0026logo=Docker\u0026logoColor=BEC5C9\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://docs.rs/git-cliff-core/\"\u003e\n        \u003cimg src=\"https://img.shields.io/docsrs/git-cliff-core?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=Rust\u0026logoColor=BEC5C9\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\n\u003ch4 align=\"center\"\u003e\n  \u003ca href=\"https://git-cliff.org/docs\"\u003eDocumentation\u003c/a\u003e |\n  \u003ca href=\"https://git-cliff.org\"\u003eWebsite\u003c/a\u003e\n\u003c/h4\u003e\n\n**git-cliff** can generate [changelog](https://en.wikipedia.org/wiki/Changelog) files from the [Git](https://git-scm.com/) history by utilizing [conventional commits](https://git-cliff.org/docs/configuration/git#conventional_commits) as well as regex-powered [custom parsers](https://git-cliff.org/docs/configuration/git#commit_parsers). The [changelog template](https://git-cliff.org/docs/category/templating) can be customized with a [configuration file](https://git-cliff.org/docs/configuration) to match the desired format.\n\n![animation](https://raw.githubusercontent.com/orhun/git-cliff/main/website/static/img/git-cliff-anim.gif)\n\n## Documentation\n\nLearn how to use **git-cliff** from the [official documentation](https://git-cliff.org/docs).\n\n- [Installation](https://git-cliff.org/docs/installation/)\n- [Usage](https://git-cliff.org/docs/usage/examples)\n- [Configuration](https://git-cliff.org/docs/configuration)\n- [Templating](https://git-cliff.org/docs/category/templating)\n\nYou can also check out the blog posts written by the community:\n\n- [An introduction to git-cliff for release management](https://substack.evancarroll.com/p/git-cliff-for-automated-release-management): Learn how to automate your software releases\n- [Git-cliff and monorepos](https://substack.evancarroll.com/p/git-cliff-and-monorepos): An introduction to the monorepo capabilities of git-cliff\n- [git-cliff: The Smart Way to Handle Changelogs](https://medium.com/@toniomasotti/git-cliff-96449950db48)\n\n## In The Media\n\n- [Turning Git commits into changelog with git-cliff](https://www.youtube.com/watch?v=RWh8qbiLRts) - RustLab 2023 (Talk)\n- [An Interview with Orhun of git-cliff](https://console.substack.com/p/console-141) - Console #141 (Newsletter)\n- [KaiCode Open Source Festival 2024](https://www.kaicode.org/2024.html) (Second place winner)\n\n## Editor Support\n\n- [git-cliff.el](https://github.com/liuyinz/git-cliff.el) - Generate, update and release changelog in Emacs\n\n## Similar/Related Projects\n\n- [git-journal](https://github.com/saschagrunert/git-journal) - The Git Commit Message and Changelog Generation Framework\n- [clog-cli](https://github.com/clog-tool/clog-cli) - Generate beautiful changelogs from your Git commit history\n- [relnotes](https://crates.io/crates/relnotes) - A tool to automatically generate release notes for your project.\n- [cocogitto](https://github.com/oknozor/cocogitto) - A set of CLI tools for the conventional commit and semver specifications.\n- [cliff-jumper](https://github.com/favware/cliff-jumper) - A NodeJS CLI tool that combines git-cliff and\n  [conventional-recommended-bump](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-recommended-bump)\n  to semantically bump a NodeJS package and generate a git-cliff powered changelog.\n- [release-plz](https://github.com/MarcoIeni/release-plz) - Release Rust packages from CI.\n- [git-changelog-command-line](https://github.com/tomasbjerre/git-changelog-command-line) - Generate changelog and determine next version with conventional commits.\n- [git-changelog](https://github.com/pawamoy/git-changelog): Automatic Changelog generator using Jinja2 templates.\n\n## Contributors\n\nThanks goes to these wonderful people ✨\n\n\u003ca href=\"https://github.com/orhun/git-cliff/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=orhun/git-cliff\" /\u003e\n\u003c/a\u003e\n\nMade with [contrib.rocks](https://contrib.rocks).\n\n## Socials\n\n\u003ca href=\"https://discord.gg/W3mAwMDWH4\"\u003e\n    \u003cimg src=\"https://discord.com/api/guilds/1093977388892819553/embed.png?style=banner2\"\u003e\u003c/a\u003e \u003c!-- \u003c/a\u003e being on the same line as the \u003cimg\u003e tag is intentional! --\u003e\n\u003cbr\u003e\n\u003ca href=\"https://matrix.to/#/#git-cliff:matrix.org\"\u003e\n    \u003cimg src=\"https://img.shields.io/matrix/git-cliff:matrix.org?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=matrix\u0026logoColor=BEC5C9\u0026label=join%20matrix\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/W3mAwMDWH4\"\u003e\n    \u003cimg src=\"https://img.shields.io/discord/1093977388892819553?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=discord\u0026logoColor=BEC5C9\u0026label=join%20discord\"\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/git_cliff\"\u003e\n    \u003cimg src=\"https://img.shields.io/twitter/follow/git_cliff?style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=twitter\u0026logoColor=BEC5C9\"\u003e\u003c/a\u003e\n\u003ca href=\"https://fosstodon.org/@git_cliff\"\u003e\n    \u003cimg src=\"https://img.shields.io/mastodon/follow/111545487385097711?domain=https%3A%2F%2Ffosstodon.org\u0026style=flat\u0026labelColor=1C2C2E\u0026color=BEC5C9\u0026logo=mastodon\u0026logoColor=BEC5C9\"\u003e\u003c/a\u003e\n\n## License\n\nLicensed under either of [Apache License Version 2.0](./LICENSE-APACHE) or [The MIT License](./LICENSE-MIT) at your option.\n\n## Copyright\n\nCopyright © 2021-2025, [git-cliff contributors](mailto:git-cliff@protonmail.com)\n","funding_links":["https://github.com/sponsors/orhun","https://patreon.com/orhunp","https://buymeacoffee.com/orhun"],"categories":["Rust","Development tools","开发工具 Development tools","Continuous integration","git","Projects using Tera","网络服务","Programming Related","rust","Changelog Tools","\u003ca name=\"git\"\u003e\u003c/a\u003eGit and accessories","\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust","Release Automation","Release Management Tools"],"sub_categories":["Web Servers","Web服务器 Web Servers","Workflow Automation","Shell into containers","Editor Support","网络服务_其他","Generators","Infrastructure as Code","Changelog Generators"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fgit-cliff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forhun%2Fgit-cliff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fgit-cliff/lists"}