git-cliff について
git-cliff は Git コミットをパースして、Conventional Commits パターンに基づいて構造化された変更ログを生成します。カスタムテンプレートとフィルタリングルールに対応しており、開発者はプロジェクト慣例に合わせたリリースノートを自動生成できます。
主な機能
- 01Conventional Commits をパースしてバージョン情報を抽出する
- 02テンプレートと設定で変更ログ形式をカスタマイズする
- 03コミットタイプ、スコープなどで提交をフィルタリング・グループ化する
- 04プロジェクト設定を初期化して変更ログを Markdown にエクスポートする
活用シーン
- 01CI/CD パイプラインでリリースノートを自動生成する
- 02チーム慣例に合わせたプロジェクト固有の変更ログスタイルを作成する
- 03オープンソースプロジェクトの一貫した バージョン履歴ドキュメントを維持する
インストール
OS またはパッケージマネージャーを選び、コマンドをターミナルで実行します。
$
インストール後にgit-cliff --versionを実行して確認します。
コマンド例
よく使うコマンドを使う順に並べています。
01
02
詳細
ドキュメント | ウェブサイト
git-cliff は、conventional commits と正規表現を活用したカスタムパーサーを利用して、Git の履歴からchangelogファイルを生成できます。設定ファイルを使ってchangelog テンプレートをカスタマイズし、希望する形式に合わせられます。

ドキュメント
公式ドキュメントでgit-cliffの使い方をご確認ください。
コミュニティが執筆したブログ記事もご覧いただけます。
- リリース管理のための git-cliff 入門:ソフトウェアのリリースを自動化する方法を学べます
- Git-cliff とモノレポ:git-cliff のモノレポ機能の入門記事です
- git-cliff:changelog を扱うスマートな方法
メディア掲載
- git-cliff で Git コミットを changelog に変換する - RustLab 2023(講演)
- git-cliff の Orhun へのインタビュー - Console #141(ニュースレター)
- KaiCode Open Source Festival 2024(準優勝)
エディターサポート
- git-cliff.el - Emacs で changelog を生成、更新、リリース
類似・関連プロジェクト
- git-journal - Git のコミットメッセージと変更履歴を生成するフレームワーク
- clog-cli - Git のコミット履歴から見栄えのよい変更履歴を生成します
- relnotes - プロジェクトのリリースノートを自動生成するツールです。
- cocogitto - Conventional Commits と semver の仕様に対応する CLI ツール群です。
- cliff-jumper - git-cliff と conventional-recommended-bump を組み合わせ、NodeJS パッケージのバージョンをセマンティックに更新し、git-cliff を活用した変更履歴を生成する NodeJS CLI ツールです。
- release-plz - CI から Rust パッケージをリリースします。
- git-changelog-command-line - Conventional Commits を使って変更履歴を生成し、次のバージョンを判定します。
- git-changelog: Jinja2 テンプレートを使った変更履歴の自動生成ツールです。
貢献者
素晴らしい皆さんに感謝します ✨
contrib.rocks で作成しました。
ソーシャル
ライセンス
Apache License Version 2.0 または The MIT License のいずれかを選択してご利用いただけます。
著作権
Copyright © 2021-2025, git-cliff contributors
コメント
Markdown 対応
