# 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 ```sh sudo av install brew:git-cliff ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install git-cliff ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install git-cliff ``` Evidence: MacPorts ports tree: devel/git-cliff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add git-cliff ``` Evidence: Alpine Linux edge package indexes: git-cliff from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#git-cliff ``` Evidence: nixpkgs package indexes: pkgs/by-name/gi/git-cliff/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S git-cliff ``` Evidence: Arch Linux sync databases: git-cliff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install git-cliff ``` Evidence: openSUSE Tumbleweed package metadata: git-cliff from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/git-cliff ``` Evidence: Scoop official bucket manifest trees: bucket/git-cliff.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id orhun.git-cliff -e ``` Evidence: Windows Package Manager source index: orhun.git-cliff from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:git-cliff - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.13.1 - **Source summary:** Highly customizable changelog generator - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 AND MIT - **Source archive:** - **Last updated:** 2026-06-22T14:03:30-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - git-cliff (cli) - git-cliff (alias) ## Dependencies - libgit2 ## Build dependencies - pkgconf - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.13.1 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/orhun/git-cliff - Upstream latest detected: v2.13.1 (current) ## 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 Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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 - Unix: cliff.toml, .cliff.toml, .config/cliff.toml, ~/cliff.toml, ~/.cliff.toml, ~/.config/cliff.toml - Windows: cliff.toml, .cliff.toml, .config/cliff.toml, C:\Users\\AppData\Roaming\cliff.toml, C:\Users\\AppData\Roaming\.cliff.toml, C:\Users\\AppData\Roaming\.config\cliff.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** git-cliff - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - git-cliff: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/git-cliff/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - git-cliff - 2.13.1-r0: normalized package name match | Alpine Linux edge package indexes: git-cliff from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A highly customizable changelog generator | https://github.com/orhun/git-cliff - apk - git-cliff-bash-completion - 2.13.1-r0: normalized package name match | Alpine Linux edge package indexes: git-cliff-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for git-cliff | https://github.com/orhun/git-cliff - apk - git-cliff-doc - 2.13.1-r0: normalized package name match | Alpine Linux edge package indexes: git-cliff-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A highly customizable changelog generator (documentation) | https://github.com/orhun/git-cliff - apk - git-cliff-fish-completion - 2.13.1-r0: normalized package name match | Alpine Linux edge package indexes: git-cliff-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for git-cliff | https://github.com/orhun/git-cliff - apk - git-cliff-zsh-completion - 2.13.1-r0: normalized package name match | Alpine Linux edge package indexes: git-cliff-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for git-cliff | https://github.com/orhun/git-cliff - pacman - git-cliff - 2.13.1-1: normalized package name match | Arch Linux sync databases: git-cliff from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A highly customizable changelog generator | https://github.com/orhun/git-cliff - zypper - git-cliff - 2.12.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: git-cliff from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Changelog generator for git repositories | https://github.com/orhun/git-cliff - zypper - git-cliff-bash-completion - 2.12.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: git-cliff-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for git-cliff | https://github.com/orhun/git-cliff - zypper - git-cliff-fish-completion - 2.12.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: git-cliff-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for git-cliff | https://github.com/orhun/git-cliff - zypper - git-cliff-zsh-completion - 2.12.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: git-cliff-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for git-cliff | https://github.com/orhun/git-cliff - MacPorts - git-cliff: normalized package name match | MacPorts ports tree: devel/git-cliff/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/git-cliff: normalized package name match | Scoop official bucket manifest trees: bucket/git-cliff.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - orhun.git-cliff: normalized package name match | Windows Package Manager source index: orhun.git-cliff from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [libgit2](https://www.automicvault.com/pkg/brew/libgit2/) - Runtime dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [cocogitto](https://www.automicvault.com/pkg/brew/cocogitto/) - Shares av.db curated category or tags: changelog, cli, conventional-commits, developer-tools, git. - [commitizen](https://www.automicvault.com/pkg/brew/commitizen/) - Shares av.db curated category or tags: changelog, cli, conventional-commits, developer-tools, git. - [changelogen](https://www.automicvault.com/pkg/brew/changelogen/) - Shares av.db curated category or tags: changelog, cli, conventional-commits, developer-tools, release-management. - [convco](https://www.automicvault.com/pkg/brew/convco/) - Shares av.db curated category or tags: changelog, cli, conventional-commits, developer-tools, release-management. - [changie](https://www.automicvault.com/pkg/brew/changie/) - Shares av.db curated category or tags: changelog, cli, developer-tools, release-management. - [gitversion](https://www.automicvault.com/pkg/brew/gitversion/) - Shares av.db curated category or tags: cli, developer-tools, git, release-management. - [commitlint](https://www.automicvault.com/pkg/brew/commitlint/) - Shares av.db curated category or tags: cli, conventional-commits, developer-tools, git. - [czg](https://www.automicvault.com/pkg/brew/czg/) - Shares av.db curated category or tags: cli, conventional-commits, developer-tools, git. - [git-cliff](https://www.automicvault.com/pkg/npm/git-cliff/) - Same normalized package name appears in another local ecosystem. Shared terms: changelog, cliff, commits, conventional, customizable. - [git-cliff](https://www.automicvault.com/pkg/npm/git-cliff/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/git-cliff.yml](https://github.com/automic-vault/db/blob/main/combined/git-cliff.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph