macOS
Homebrewverified · 100%
brew install git-clifflocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install git-cliffMacPorts ports tree · devel/git-cliff/Portfile · source: api.github.com
brew
Install git-cliff with Homebrew, apk, MacPorts, Nix, pacman, scoop, winget, zypper
Highly customizable changelog generator. Version 2.13.1 via Homebrew; verified 2026-06-22.
install
Additional install commands
Linux
Alpine Linux apkverified · 92%
sudo apk add git-cliffAlpine Linux edge package indexes · git-cliff · source: dl-cdn.alpinelinux.org
Nixverified · 92%
nix profile install nixpkgs#git-cliffnixpkgs package indexes · pkgs/by-name/gi/git-cliff/package.nix · source: api.github.com
Arch Linux pacmanverified · 92%
sudo pacman -S git-cliffArch Linux sync databases · git-cliff · source: geo.mirror.pkgbuild.com
openSUSE zypperverified · 92%
sudo zypper install git-cliffopenSUSE Tumbleweed package metadata · git-cliff · source: download.opensuse.org
Windows
Scoopverified · 92%
scoop install main/git-cliffScoop official bucket manifest trees · bucket/git-cliff.json · source: api.github.com
Windows Package Managerverified · 92%
winget install --id orhun.git-cliff -eWindows Package Manager source index · orhun.git-cliff · source: cdn.winget.microsoft.com
overview
Package summary
Highly customizable changelog generator
Project links
Commands and aliases
- git-cliff
history
Project history and usage
git-cliff is a Rust changelog generator that derives release notes from Git history. It sits in the release-engineering space around Conventional Commits, templated changelogs, and automated package publishing.
Project history
The project is authored by Orhun Parmaksiz and began its documented release series with v0.1.0 on 2021-08-12. Its changelog records steady growth across the 0.x line into 2022 and a larger 2.x line by 2026, with work on configuration, templating, remote integrations, CI packaging, npm packaging, PyPI wheels, and Docker images.
Adoption history
git-cliff gained adoption because it solves a recurring maintainer problem: turning commit history into readable release notes without hand-editing every release. The README links official documentation, community writing, a RustLab 2023 talk, an interview, editor support, and related projects, which shows a tool with a visible release-management ecosystem rather than a one-off script.
How it is used
Practitioners configure cliff.toml, choose parsers for Conventional Commits or custom commit patterns, and render changelogs through the CLI or in CI. The template system lets maintainers align generated notes with project conventions while still deriving content from Git data.
Why package nerds care
For package maintainers, git-cliff matters because it packages release-note generation as a reproducible build step. Its availability across Homebrew, Linux distributions, Scoop, winget, crates.io, npm, PyPI, and container workflows makes it easy to use in heterogeneous release pipelines.
Timeline
- 2021: v0.1.0 release documented in the changelog.
- 2022: 0.8.x releases continued the early public line.
- 2026: 2.13.x changelog entries documented mature CI, packaging, configuration, and remote work.
Related projects
- The README lists related changelog and release tools including git-journal, clog-cli, relnotes, cocogitto, release-plz, and other Git changelog generators.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 1 runtime dependencies.
- Build metadata lists 2 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
cliff.toml.cliff.toml.config/cliff.toml~/cliff.toml~/.cliff.toml~/.config/cliff.toml- Windows
cliff.toml.cliff.toml.config/cliff.tomlC:\Users\<user>\AppData\Roaming\cliff.tomlC:\Users\<user>\AppData\Roaming\.cliff.tomlC:\Users\<user>\AppData\Roaming\.config\cliff.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
git-cliff | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version2.13.1
manager updated2026-06-22
local dataok
upstreamcurrent
latest detectedv2.13.1
https://github.com/orhun/git-cliff
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:git-cliff |
|---|---|
| Version | 2.13.1 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/git-cliff |
| Homepage | https://git-cliff.org/ |
| Repository | https://github.com/orhun/git-cliff |
| Upstream docs | https://git-cliff.org/docs |
| License | Apache-2.0 AND MIT |
| Source archive | https://github.com/orhun/git-cliff/archive/refs/tags/v2.13.1.tar.gz |
| Last updated | 2026-06-22T14:03:30-07:00 |
| Pulse | updated |
| Dependencies | libgit2 |
| Build dependencies | pkgconf, rust |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | git-cliff |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
git-cliff
nix profile install nixpkgs#git-cliff- normalized package name match
- Matched by: Git Cliff
apk95%
git-cliff 2.13.1-r0
A highly customizable changelog generator
https://github.com/orhun/git-cliff
sudo apk add git-cliff- License: MIT OR Apache-2.0
- Architecture: x86_64
- Source Package: git-cliff
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Git Cliff
apk95%
git-cliff-bash-completion 2.13.1-r0
Bash completions for git-cliff
https://github.com/orhun/git-cliff
sudo apk add git-cliff-bash-completion- License: MIT OR Apache-2.0
- Architecture: x86_64
- Source Package: git-cliff
- normalized package name match
- Matched by: Git Cliff
apk95%
git-cliff-doc 2.13.1-r0
A highly customizable changelog generator (documentation)
https://github.com/orhun/git-cliff
sudo apk add git-cliff-doc- License: MIT OR Apache-2.0
- Architecture: x86_64
- Source Package: git-cliff
- normalized package name match
- Matched by: Git Cliff
apk95%
git-cliff-fish-completion 2.13.1-r0
Fish completions for git-cliff
https://github.com/orhun/git-cliff
sudo apk add git-cliff-fish-completion- License: MIT OR Apache-2.0
- Architecture: x86_64
- Source Package: git-cliff
- normalized package name match
- Matched by: Git Cliff
apk95%
git-cliff-zsh-completion 2.13.1-r0
Zsh completions for git-cliff
https://github.com/orhun/git-cliff
sudo apk add git-cliff-zsh-completion- License: MIT OR Apache-2.0
- Architecture: x86_64
- Source Package: git-cliff
- normalized package name match
- Matched by: Git Cliff
pacman95%
git-cliff 2.13.1-1
A highly customizable changelog generator
https://github.com/orhun/git-cliff
sudo pacman -S git-cliff- License: MIT AND Apache-2.0
- Architecture: x86_64
- 6 dependencies
- normalized package name match
- Matched by: Git Cliff
zypper95%
git-cliff 2.12.0-1.1
Changelog generator for git repositories
https://github.com/orhun/git-cliff
sudo zypper install git-cliff- License: (Apache-2.0 OR MIT) AND Unicode-DFS-2016 AND (0BSD OR MIT OR Apache-2.0) AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 OR MIT) AND
- Category: Unspecified
- Architecture: x86_64
- Source Package: git-cliff
- 3 dependencies
- 2 provides
- normalized package name match
- Matched by: Git Cliff
zypper95%
git-cliff-bash-completion 2.12.0-1.1
Bash Completion for git-cliff
https://github.com/orhun/git-cliff
sudo zypper install git-cliff-bash-completion- License: (Apache-2.0 OR MIT) AND Unicode-DFS-2016 AND (0BSD OR MIT OR Apache-2.0) AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 OR MIT) AND
- Category: System/Shells
- Architecture: noarch
- Source Package: git-cliff
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Git Cliff
zypper95%
git-cliff-fish-completion 2.12.0-1.1
Fish Completion for git-cliff
https://github.com/orhun/git-cliff
sudo zypper install git-cliff-fish-completion- License: (Apache-2.0 OR MIT) AND Unicode-DFS-2016 AND (0BSD OR MIT OR Apache-2.0) AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 OR MIT) AND
- Category: System/Shells
- Architecture: noarch
- Source Package: git-cliff
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Git Cliff
zypper95%
git-cliff-zsh-completion 2.12.0-1.1
Zsh Completion for git-cliff
https://github.com/orhun/git-cliff
sudo zypper install git-cliff-zsh-completion- License: (Apache-2.0 OR MIT) AND Unicode-DFS-2016 AND (0BSD OR MIT OR Apache-2.0) AND (Apache-2.0 OR BSL-1.0) AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 OR MIT) AND
- Category: System/Shells
- Architecture: noarch
- Source Package: git-cliff
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Git Cliff
MacPorts95%
git-cliff
sudo port install git-cliff- normalized package name match
- Matched by: Git Cliff
Scoop95%
main/git-cliff
scoop install main/git-cliff- normalized package name match
- Matched by: Git Cliff
winget95%
orhun.git-cliff
winget install --id orhun.git-cliff -e- normalized package name match
- Matched by: Git Cliff
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- av.db category and tag curation
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment