GitHub PRとIssueのフィルター検索：is:merged is:openまとめ
基本フィルター
GitHubのPR・Issue一覧画面の検索ボックスに入力するフィルター構文です。
タイプで絞る
is:pr PRのみ is:issue Issueのみ
ステータスで絞る
is:open オープン is:closed クローズ済み is:merged マージ済み（PRのみ） is:draft ドラフト（PRのみ） is:unmerged マージされていないPR
組み合わせ例：
is:pr is:merged マージ済みのPR is:pr is:open is:draft ドラフト中のPR is:issue is:closed クローズ済みのIssue
担当・レビュー
author:username 自分が作成したPR・Issue assignee:username アサインされているもの assignee:@me 自分にアサインされているもの reviewer:username レビュアーが指定されているPR review-requested:@me 自分にレビューリクエストされているPR
review:approved 承認済みのPR review:changes-requested 変更要求があるPR review:none レビューなしのPR
ラベル・マイルストーン
label:bug ラベルで絞る label:bug,enhancement 複数ラベル（AND条件） -label:bug ラベルを除外 milestone:"v1.0" マイルストーンで絞る no:label ラベルなし no:milestone マイルストーンなし
ブランチ・コミット
base:main ベースブランチがmain head:feature-xxx ヘッドブランチ名で絞る
日付
created:>2024-01-01 2024年1月1日以降に作成 updated:<2024-06-01 2024年6月1日以前に更新 closed:2024-05-01..2024-05-31 5月中にクローズ merged:>2024-01-01 2024年1月以降にマージ
よく使う組み合わせ
# 自分にアサインされたオープンなIssue is:issue is:open assignee:@me # レビュー依頼が来ているPR is:pr is:open review-requested:@me # 自分が作成してまだマージされていないPR is:pr is:open author:@me # バグラベルのクローズ済みIssue is:issue is:closed label:bug # mainへのマージ済みPR（直近） is:pr is:merged base:main sort:updated-desc
gh コマンドで絞る
gh pr list / gh issue list でも同様のフィルタリングができます。
PR
# オープンなPR一覧（デフォルト） gh pr list # ステータスで絞る gh pr list --state open gh pr list --state closed gh pr list --state merged # 自分が作成したPR gh pr list --author "@me" # アサインされたPR gh pr list --assignee "@me" # ラベルで絞る gh pr list --label bug # ベースブランチで絞る gh pr list --base main # ドラフトのみ gh pr list --draft # 件数を増やす（デフォルト30件） gh pr list --limit 100
Issue
# オープンなIssue一覧（デフォルト） gh issue list # ステータスで絞る gh issue list --state open gh issue list --state closed gh issue list --state all # アサインされたIssue gh issue list --assignee "@me" # ラベルで絞る gh issue list --label bug gh issue list --label "bug,enhancement" # マイルストーンで絞る gh issue list --milestone "v1.0"
gh search（横断検索）
# リポジトリをまたいでPRを検索 gh search prs --state merged --author "@me" # 自分にレビュー依頼されているPR gh search prs --review-requested "@me" --state open # Issueをキーワード検索 gh search issues "バグ" --label bug --state open
フィルター構文とghコマンドの対応表
| Web UI フィルター | gh コマンド |
|---|---|
is:open |
--state open |
is:closed |
--state closed |
is:merged |
--state merged |
is:draft |
--draft |
author:@me |
--author "@me" |
assignee:@me |
--assignee "@me" |
label:bug |
--label bug |
base:main |
--base main |
milestone:v1.0 |
--milestone "v1.0" |
review-requested:@me |
gh search prs --review-requested "@me" |
まとめ
| やりたいこと | フィルター |
|---|---|
| マージ済みPRを見る | is:pr is:merged |
| 自分のレビュー待ちPR | is:pr is:open review-requested:@me |
| 自分のオープンなIssue | is:issue is:open assignee:@me |
| ドラフトPRを確認 | is:pr is:draft |
| バグラベルのIssue | is:issue label:bug |
gh pr list/gh issue listはカレントリポジトリが対象- リポジトリをまたいで検索するには
gh search prs/gh search issuesを使う @meは認証中のユーザー自身を指す
よく使うGit・GitHubコマンドは「Git & GitHub Tips集：知っておくと便利なコマンド・操作まとめ」も参照してください。
