install

Additional install commands

macOS

Homebrewverified · 100%

brew install git-cliff

provider-native install command

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 bottle metadata was recorded.

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`	executable	indexed executable	Discovered from the local executable index.

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-08-03

manager version2.13.1

manager updated2026-06-22

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:git-cliff
Version	2.13.1
Package manager	Homebrew
Homepage	https://git-cliff.org/
Repository	https://github.com/orhun/git-cliff
Last updated	2026-06-22T14:03:30-07:00
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

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.

combined/git-cliff.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install git-cliff with Homebrew