Songmu/tagpr

これは何？

主な機能

• 01バージョンと変更履歴を自動更新するリリース用Pull Requestを管理します。
• 02リリースブランチに新しいコミットが追加されると、リリース用PRを更新します。
• 03マージされたリリースコミットにタグを付け、GitHub Releaseを作成できます。
• 04PRラベルに基づいてSemVerの更新幅を決定でき、CalVerやタグのみのリリースにも対応します。
• 05モノレポ用のタグプレフィックスと、メジャーバージョンを固定したメンテナンスブランチに対応します。

ユースケース

• Goなど、GitHubでホストされているプロジェクトのバージョン更新と変更履歴の作成を自動化する。
• リリース時に作成されるタグをきっかけに、ビルドや公開のワークフローを実行する。
• モノレポ内のバージョンを個別に管理するパッケージをリリースする。

クイックスタート

1. 1

   main からリリースするリポジトリに tagpr のワークフローファイルを追加します

2. 2

   リポジトリの設定で「GitHub Actions によるプルリクエストの作成と承認を許可する」を有効にします

3. 3

   ワークフローをコミットして main にプッシュします

使う前に知っておきたいこと

• !GitHub Actions 内でのみ実行され、contents と pull requests への書き込み権限が必要です。
• !GITHUB_TOKEN で作成されたタグでは、GitHub App トークンを使用しない限り、タグをトリガーとする別のワークフローは実行されません。

収録されている特集

トピック

よくある質問

tagpr とは？

リリース用Pull Requestのバージョン更新と変更履歴を管理し、マージ時にタグ付けしてGitHub Releaseを公開するGitHub Actionです。 tagprは、GitHubでホストされているプロジェクトのリリース準備を自動化します。リリースブランチ上のリリース用Pull Requestを継続的に管理し、次のバージョンを提案するとともに、バージョンファイルとCHANGELOG.mdを更新します。Pull Requestはリリースブランチへの新しいコミットを反映するため、メンテナーがマージするまで最新の状態に保たれます。

tagpr は無料で使えますか？ライセンスは？

tagpr は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

tagpr は今もメンテナンスされていますか？

活発にメンテナンス中。tagpr の最終コミットは 2026年11月6日 です。

tagpr は何に使えますか？

Goなど、GitHubでホストされているプロジェクトのバージョン更新と変更履歴の作成を自動化する。 リリース時に作成されるタグをきっかけに、ビルドや公開のワークフローを実行する。 モノレポ内のバージョンを個別に管理するパッケージをリリースする。

tagpr のインストール方法は？

main からリリースするリポジトリに tagpr のワークフローファイルを追加します リポジトリの設定で「GitHub Actions によるプルリクエストの作成と承認を許可する」を有効にします ワークフローをコミットして main にプッシュします

tagpr はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Songmu/tagpr