mcpField
G
git-cliff

git-cliff

公式Agent-ready
github.com開発ツール12.3kgit-cliff4 日前に更新
リポジトリ公式サイト

git-cliff について

git-cliff は Git コミットをパースして、Conventional Commits パターンに基づいて構造化された変更ログを生成します。カスタムテンプレートとフィルタリングルールに対応しており、開発者はプロジェクト慣例に合わせたリリースノートを自動生成できます。

主な機能

  1. 01Conventional Commits をパースしてバージョン情報を抽出する
  2. 02テンプレートと設定で変更ログ形式をカスタマイズする
  3. 03コミットタイプ、スコープなどで提交をフィルタリング・グループ化する
  4. 04プロジェクト設定を初期化して変更ログを Markdown にエクスポートする

活用シーン

  1. 01CI/CD パイプラインでリリースノートを自動生成する
  2. 02チーム慣例に合わせたプロジェクト固有の変更ログスタイルを作成する
  3. 03オープンソースプロジェクトの一貫した バージョン履歴ドキュメントを維持する

インストール

OS またはパッケージマネージャーを選び、コマンドをターミナルで実行します。

$
brew install git-cliff

インストール後にgit-cliff --versionを実行して確認します。

コマンド例

よく使うコマンドを使う順に並べています。

01
git cliff --init
02
git cliff -o CHANGELOG.md

詳細

README の画像
README の画像 README の画像 README の画像
README の画像 README の画像 README の画像 README の画像

ドキュメント | ウェブサイト

git-cliff は、conventional commits と正規表現を活用したカスタムパーサーを利用して、Git の履歴からchangelogファイルを生成できます。設定ファイルを使ってchangelog テンプレートをカスタマイズし、希望する形式に合わせられます。

アニメーション

ドキュメント

公式ドキュメントでgit-cliffの使い方をご確認ください。

コミュニティが執筆したブログ記事もご覧いただけます。

メディア掲載

エディターサポート

  • 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 テンプレートを使った変更履歴の自動生成ツールです。

貢献者

素晴らしい皆さんに感謝します ✨

README の画像

contrib.rocks で作成しました。

ソーシャル

README の画像
README の画像 README の画像 README の画像 README の画像

ライセンス

Apache License Version 2.0 または The MIT License のいずれかを選択してご利用いただけます。

著作権

Copyright © 2021-2025, git-cliff contributors

コメント