GitHub CLI(ターミナルからGitHubを操作する公式コマンド。コマンド名は gh)に、プルリクエストの変化を待つためのコマンドが加わりました。2026年11月18日のGitHub Changelogで発表された gh event listen は、GitHub CLI でプルリクエストのレビューやチェックの完了を待つときに、gh コマンドをループで何度も叩いて確認する作り方を置き換えるものです。Claude CodeやGitHub Copilotにプルリクエスト(PR)を作らせている個人にも関係します。
要点
- GitHub CLI が GitHub Event Streams に対応し、gh v2.105.0 以降で
gh event listenが使える - PRのURLと知りたいイベントを指定すると、サブスクリプションを作成してストリームを開き、各イベントを1行のJSONで出力する
- 既定では最初のイベントを受け取った時点で終了するため、スクリプトやエージェントのループに組み込める
- 待てるのは、提出されたレビュー、PRの state と head の変更、マージコンフリクト、完了した check suite
- gh event コマンドはプレビューで、Event Streams へのアクセス(waitlist 登録)が必要
何が発表されたか
2026年11月18日のGitHub Changelogで、GitHub CLI が GitHub Event Streams に対応したことが発表されました。gh v2.105.0 では、ユーザーやエージェントがループでポーリング(同じ問い合わせを繰り返して変化を探ること)する代わりに、1つのコマンドでPRの変化を待てるようになりました。
基本の使い方
PRのURLと、知りたいイベント(たとえば提出されたレビュー)を指定して gh event listen を実行します。コマンドはサブスクリプション(購読の設定)を作成し、ストリームを開き、各イベントを1行のJSONとして出力します。既定では最初のイベントの後に終了するので、スクリプトやエージェントのループに収まります。GitHub Docsによると、同じPRと同じイベント種類のサブスクリプションが既にあればそれを再利用し、ストリームが切れたときは再接続し、失効していればサブスクリプションを作り直します。
使えるオプション
--count で複数のイベントを待ち、--follow で待ち続け、--timeout で待機を打ち切ります。--timeout は 30m のような長さを指定でき、打ち切ったときは終了ステータス8で終わります。--jq と --template では必要なフィールドだけを取り出せます。たとえば --jq .data.conclusion は check suite の conclusion だけを表示します。
待てるイベントの種類
提出されたレビュー、PRの state と head の変更、マージコンフリクト、完了した check suite を待てます。Docsに載っているイベント名と送信条件は次の5つです。
com.github.pull_request.review.submitted.v1: 誰かが承認・変更要求・コメントのレビューを提出したときcom.github.pull_request.state.changed.v1: PRがマージ・クローズ・再オープン・レビュー準備完了・ドラフト化されたときcom.github.pull_request.head.changed.v1: push などでPRの head コミットが変わったときcom.github.pull_request.merge_conflict.v1: GitHubがPRのマージコンフリクトを見つけたときcom.github.pull_request.check_suite.status.changed.v1: head コミットの check suite が結果にかかわらず完了したとき
サブスクリプションを直接管理するには gh event subscription create, list, view, and delete を使います。
エージェント向けの案内も変わった
エージェントは新しいコマンドを自分で見つけられるようになっています。gh pr create、gh pr view、gh run view、gh run watch、gh api が、ポーリングの代わりに gh event listen を提案するようになりました。
土台になる GitHub Event Streams
GitHub Event Streams は、エージェントや連携ツールがリソースの変更をポーリングする代わりに購読できるようにする仕組みです。2026年11月17日のGitHub Changelogでは、waitlist で承認されればすべてのGitHubプランでプレビュー利用できると案内されました。現時点ではPRのイベントに対応しています。イベントは Server-Sent Events(SSE。接続を開いたままサーバーから送り続ける方式)で配信され、webhook のように公開エンドポイントを用意する必要がありません。Changelogでは、ポーリングを頻繁にすると中身の変わらない問い合わせでレート制限の予算を消費するという課題と、トークンの無駄やレート制限の消費が減りポーリングのループを作って調整する必要がなくなるという利点が説明されています。
個人の仕事や学びにどう使えるか
エンジニアがClaude Codeなどに実装させてPRを出したあと、CIの結果を見るためにターミナルに戻って何度も確認する手間を減らせます。check suite の完了を待つイベントは data.conclusion を持つため、--jq .data.conclusion で成功か失敗かだけを受け取ってから次の作業に移る、という流れが作れます。
副業やフリーランスで複数のリポジトリを掛け持ちしている人は、レビュー待ちのPRごとに gh event listen を仕掛けておき、レビューが提出された時点で手を動かす形にできます。待っている間は自分の別の作業に集中できます。
Webディレクターやデータ分析の担当者のように、コードレビューを依頼する側に回ることが多い職種でも、--follow でPRの state 変更を見続け、マージやクローズのタイミングを把握する使い方が考えられます。
会社・チームで使うときのポイント
Event Streams はアカウント単位で有効化され、GitHub Appのインストールトークンでは、そのAppを入れたユーザー・組織・エンタープライズが対象になります。GitHub Actions の GITHUB_TOKEN も含まれますが、メンバー個人のトークンは含まれません。サブスクリプションの上限は1トークンあたり100件で、24時間で失効するため、チームで自動化を組むなら不要な購読を削除する運用まで決めておくと安全です。法人での導入や研修を検討している場合は、累計600社超・5万人以上のAI活用を支援してきた株式会社デジライズに相談できます。
使う前の注意点
gh event コマンドはプレビューで、変更される可能性があります。利用には Event Streams へのアクセスが必要で、Event Streams は GitHub.com でプレビュー中です。アクセスを得るには Event Streams の waitlist に登録します。Event Streams は GitHub.com でのみ利用でき、GHE.com ではまだ利用できません。使うには gh v2.105.0 以降へのアップグレードが必要です。
認証はユーザートークンかGitHub Appのインストールアクセストークンで、App自身として認証する方法は対応していません。購読するPRへの読み取り権限も必要です。1つのサブスクリプションが対象とするのは1つのPRです。
仕組みの上での注意も押さえておきたい点です。イベントは「何かが変わった」ことを伝えるもので、何が変わったかは含みません(check suite のイベントは例外で、data.conclusion が常に含まれます)。同じイベントが複数回届くことがあり、ストリームは開いている間のイベントだけを届けるため、購読後に一度PRを取得して取りこぼしを確認します。gh event listen はストリームが開くと「Listening for events.」を標準エラー出力に表示し、それ以前の変更は報告されません。終了してもサブスクリプションは削除されません。
既知の制限として、「すべてのチェックが完了した」というイベントはなく、check suite ごとに1イベントが届きます。PRの会話タブのコメントはまだイベントになりません(レビューコメントはレビューのイベントとして届き、1件ごとのレビューコメントや返信もレビューとして数えられます)。REST APIで作成したコミットステータスは check suite のイベントに含まれません。マージコンフリクトのイベントは他のイベントより届くのが遅くなることがあります。サブスクリプションを削除しても開いているストリームはまだ閉じないため、先にストリームを閉じます。提供範囲や条件はプレビュー中に変わり得るので、使う前に公式のヘルプで最新の内容を確かめてください。
まとめ
gh event listen は、PRのレビューやチェックの完了を待つ処理をコマンド1つに置き換えるものです。AIエージェントにPRを作らせる前提で自動化を組んでいる人ほど、待ち方の設計が効いてきます。こうしたエージェント運用を体系的に学ぶなら、デジライズAIスクールのコース一覧にある「5.マルチエージェントと自動化 ~ Claude~」から始めるのも一つの手です。
出典
- Wait for pull request events with GitHub CLI - GitHub Changelog
- Using GitHub Event Streams - GitHub Docs
- GitHub Event Streams is now in preview - GitHub Changelog
この記事は、各社の公式の発表をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。
