GitHubの「Repository switcher generally available in global navigation」は、複数リポジトリを行き来する人ほど便利な新しいリポジトリ切り替え機能です。結論から言うと、リポジトリ名の横にある下向き矢印を開き、同じ Organization または owner namespace 内の別リポジトリを検索して移動できます。従来のようにトップページや検索画面へ戻らなくても、現在のページから近い操作で移動できる点が実務上のメリットです。GitHub Changelogでは2026年6月18日付で一般提供が案内されており、指定URL上の分類表示は「Improvement」です。(The GitHub Blog)
Repository switcher generally available in global navigation の使い方・設定で迷うポイント
Repository switcher generally available in global navigation は、GitHubのグローバルナビゲーションからリポジトリを切り替えるための機能です。GitHub公式情報では、ナビゲーションのパンくずに表示されるリポジトリ名の横にある chevron、つまり下向き矢印を選択するとダイアログが開き、別のリポジトリを検索・選択できると説明されています。(The GitHub Blog)
この機能で迷いやすいのは、「どこで設定するのか」「すべてのリポジトリが出るのか」「ブランチやPull Requestを切り替える機能なのか」という点です。まず押さえるべきことは、これは管理者が有効化するような大きな設定機能ではなく、GitHubの画面上でリポジトリ間を移動しやすくするナビゲーション機能だということです。
たとえば、次のような場面で役立ちます。
| 利用シーン | 従来迷いやすかったこと | Repository switcherで楽になること |
|---|---|---|
| フロントエンドとバックエンドのリポジトリを行き来する | Organizationページへ戻ってリポジトリを探す | 現在の画面から近い操作で別リポジトリへ移動できる |
| 複数サービスのIssueを確認する | ブックマークや検索に頼りがち | リポジトリ名から検索して移動しやすい |
| モノレポではなく複数リポジトリで開発している | 関連リポジトリの場所を忘れやすい | owner namespace内のリポジトリを探しやすい |
| 管理者・レビュアーが多数のリポジトリを見る | タブやURL移動が増える | クロスリポジトリの確認作業を短縮できる |
Repository switcherでできること
この機能でできることは、現在開いているGitHubページから、別のリポジトリへ素早く移動することです。公式説明では、現在のページを離れてトップページなどへ戻らなくても、グローバルナビゲーション上のリポジトリスイッチャーから別リポジトリへジャンプできるとされています。(The GitHub Blog)
操作の基本は次の流れです。
| 手順 | 操作 | 確認ポイント |
|---|---|---|
| 1 | GitHubで任意のリポジトリページを開く | リポジトリの画面上部にパンくずが表示されているか確認する |
| 2 | リポジトリ名の横にある下向き矢印をクリックする | ダイアログが開く |
| 3 | 移動したいリポジトリ名を入力する | Organizationまたはowner namespace内のリポジトリを検索する |
| 4 | 候補からリポジトリを選択する | 選んだリポジトリへ移動する |
ポイントは、GitHub全体を横断して無制限に探す機能ではないことです。公式説明では、検索・選択できる対象は「your organization or owner namespace」の別リポジトリとされています。(The GitHub Blog)
設定場所はどこか：基本的にはリポジトリ画面のナビゲーションから使う
Repository switcher generally available in global navigation は、GitHubのSettings画面で細かく設定してから使うタイプの機能ではありません。利用時に探す場所は、リポジトリ画面上部のナビゲーションです。
迷ったときは、次の順に確認してください。
| 確認したいこと | 見る場所 | 判断の目安 |
|---|---|---|
| 機能を開く場所 | リポジトリ名の横の下向き矢印 | パンくず内のリポジトリ名付近を見る |
| 切り替え先を探す場所 | 開いたダイアログ内の検索欄 | リポジトリ名の一部を入力する |
| 対象範囲 | 同じOrganizationまたはowner namespace | 関係ないOrganizationのリポジトリは出ない可能性がある |
| 管理者設定の有無 | 個別設定ではなくナビゲーション機能として利用 | 表示されるかどうかを画面上で確認する |
「設定場所が見つからない」と感じる場合、GitHubのOrganization SettingsやRepository Settingsを探している可能性があります。しかし、この機能はリポジトリの権限や保護ルールを設定するものではなく、画面移動を短縮するためのUI機能です。
導入前に確認したい前提条件
Repository switcherを使う前に、管理者やチームリーダーは次の前提を確認しておくと混乱を減らせます。
| 前提条件 | 確認内容 | 実務での注意点 |
|---|---|---|
| GitHub上で対象リポジトリにアクセスできること | ユーザーが移動先リポジトリを閲覧できるか | 権限がないリポジトリは候補に出ない、または開けない可能性がある |
| 同じOrganizationまたはowner namespace内で探すこと | 移動したいリポジトリが同じ管理単位にあるか | 別Organizationのリポジトリは別途移動が必要になることがある |
| リポジトリ名が分かること | 検索に使う名前や略称をチーム内で共有しているか | 命名規則がバラバラだと検索しにくい |
| チームが複数リポジトリ運用をしていること | フロントエンド、API、インフラなどが分かれているか | 関連リポジトリの一覧をREADMEなどに置くとさらに使いやすい |
特に重要なのは、Repository switcherは「アクセス権の代わり」にはならないという点です。候補から選ぶための機能であって、リポジトリの閲覧権限や管理権限を付与する機能ではありません。新しいメンバーが「検索してもリポジトリが出ない」と言っている場合は、まずリポジトリ名の入力ミス、所属Organization、権限の有無を確認するとよいでしょう。
初心者が勘違いしやすいポイント
ブランチ切り替え機能ではない
Repository switcherという名前から、ブランチやタグを切り替える機能と混同する人がいます。しかし、この機能はリポジトリそのものを切り替えるためのものです。
ブランチを切り替えたい場合は、リポジトリ内のブランチ選択UIを使います。Repository switcherは、たとえば frontend-app から backend-api へ移動するような場面で使います。
GitHub全体の検索機能ではない
Repository switcherは、GitHub全体の公開リポジトリを探すための検索機能ではありません。公式説明では、Organizationまたはowner namespace内の別リポジトリを検索・選択する機能として案内されています。(The GitHub Blog)
公開リポジトリを広く探したい場合は、GitHubの通常検索を使う方が適しています。Repository switcherは、普段使っている関連リポジトリへの移動を短くするためのものです。
すべての画面で同じように見えるとは限らない
GitHubのUIは、表示しているページの種類や画面幅によって見え方が変わることがあります。Repository switcherを探すときは、リポジトリページの上部にあるパンくずとリポジトリ名の横を確認してください。
ブラウザ幅が狭い場合や、モバイル表示に近い状態では、ナビゲーション要素の表示位置が変わることがあります。見つからないときは、まずブラウザ幅を広げる、ページを再読み込みする、別のリポジトリページで確認する、という順で切り分けるとよいでしょう。
表示されない・使えないときの確認手順
Repository switcherが見つからない、または思ったリポジトリが表示されない場合は、次の順で確認します。
| 症状 | よくある原因 | 確認方法 |
|---|---|---|
| 下向き矢印が見つからない | 見ている画面がリポジトリページではない | 任意のリポジトリトップ、Issue、Pull Requestなどで確認する |
| 候補に出ない | リポジトリ名の入力が一致していない | 正式なリポジトリ名の一部で検索する |
| 候補に出ない | 別Organizationのリポジトリを探している | 移動先リポジトリの所属Organizationを確認する |
| 候補に出ない | 権限が不足している | Organization管理者やリポジトリ管理者にアクセス権を確認する |
| 開いても目的の画面ではない | リポジトリ単位での移動になっている | IssueやPR番号まで同じ位置に移動する機能ではないと考える |
実務では、「機能が使えない」と判断する前に、まず対象リポジトリの所属とアクセス権を確認するのが近道です。特にEnterpriseや複数Organizationを使っている環境では、似た名前のリポジトリが別Organizationに存在することがあります。
チームで使うときのおすすめ運用
Repository switcherは個人の移動を楽にする機能ですが、チーム運用と組み合わせるとさらに効果が出ます。特に複数リポジトリを扱う開発チームでは、次の工夫が有効です。
リポジトリ名の命名規則をそろえる
検索しやすさは、リポジトリ名に大きく左右されます。たとえば、次のように役割が分かる名前にしておくと、Repository switcherで探しやすくなります。
| 悪い例 | 改善例 | 理由 |
|---|---|---|
app | customer-portal-frontend | 何のアプリか分かる |
api | customer-portal-api | 関連サービスを検索しやすい |
infra | customer-portal-infra | フロントエンド・APIと関連付けやすい |
test | payment-service-test-tools | 用途が明確になる |
Repository switcher自体は便利ですが、リポジトリ名が曖昧だと検索時に迷います。チームで複数リポジトリを扱うなら、機能の使い方だけでなく、リポジトリ命名も見直す価値があります。
READMEやドキュメントに関連リポジトリを明記する
Repository switcherは移動を速くしますが、「どのリポジトリへ移動すべきか」までは判断してくれません。新しく参加したメンバー向けには、READMEや開発者向けドキュメントに関連リポジトリをまとめておくと親切です。
例として、サービス単位で次のように整理します。
| 種別 | リポジトリ例 | 用途 |
|---|---|---|
| フロントエンド | customer-portal-frontend | 画面・UI |
| API | customer-portal-api | バックエンドAPI |
| インフラ | customer-portal-infra | Terraform、GitHub Actions設定 |
| ドキュメント | customer-portal-docs | 仕様書、運用手順 |
この一覧があれば、Repository switcherで検索するキーワードも分かりやすくなります。
レビュー担当者は移動パターンを決めておく
複数リポジトリにまたがる変更では、レビュー担当者が「どの順番で確認するか」を決めておくと効率が上がります。
たとえば、API変更を含むフロントエンド改修では、次の順で確認すると手戻りを減らせます。
| 確認順 | 見るリポジトリ | 確認内容 |
|---|---|---|
| 1 | APIリポジトリ | エンドポイント、レスポンス形式、互換性 |
| 2 | フロントエンドリポジトリ | API呼び出し、表示、エラーハンドリング |
| 3 | インフラリポジトリ | 環境変数、デプロイ設定、権限 |
| 4 | ドキュメントリポジトリ | 利用者向け説明、運用手順 |
Repository switcherを使えば、このような横断確認時の移動負担を減らせます。
管理者がメンバーに案内するときの説明例
社内やチーム内に案内する場合は、機能名をそのまま伝えるだけでは伝わりにくいことがあります。次のように、使う場面と操作場所をセットで説明すると理解されやすくなります。
GitHubのリポジトリ画面上部にあるリポジトリ名の横の下向き矢印から、同じOrganization内の別リポジトリへ移動できます。複数リポジトリを確認するときは、GitHubトップへ戻らず、このRepository switcherを使うと便利です。
さらに、チーム独自の補足として次の情報を加えると実用的です。
| 案内項目 | 書いておく内容 |
|---|---|
| 対象Organization | 自社・チームで使っているOrganization名 |
| よく使うリポジトリ | フロントエンド、API、インフラ、ドキュメントなど |
| 権限がない場合の連絡先 | Organization管理者、リポジトリ管理者、情シス窓口 |
| 命名ルール | サービス名、用途、環境名の付け方 |
単に「新機能が追加されました」と伝えるより、「どの作業が楽になるのか」まで書いた方が定着しやすくなります。
Repository switcherを使うべき人・あまり影響がない人
Repository switcherは便利な機能ですが、すべてのユーザーに大きな変化があるわけではありません。影響が大きいのは、複数リポジトリを日常的に横断する人です。
| ユーザー | 影響度 | 理由 |
|---|---|---|
| 複数リポジトリを担当する開発者 | 高 | 関連リポジトリへの移動が多い |
| Pull Requestを横断レビューするリードエンジニア | 高 | API、UI、インフラを行き来しやすい |
| Organization管理者 | 中 | 権限確認や設定確認で複数リポジトリを見ることがある |
| 1つのリポジトリだけを使うユーザー | 低 | 移動先が少ないため効果は限定的 |
| GitHubを検索中心で使うユーザー | 低 | GitHub全体検索とは用途が異なる |
1つのリポジトリだけで作業している場合、この機能の効果はあまり感じないかもしれません。一方で、マイクロサービス構成や複数プロダクトを運用しているチームでは、日々の小さな移動時間を減らせます。
導入時に失敗しやすいポイント
Repository switcherは操作自体はシンプルですが、チームに案内するときは次の点で誤解が起きやすくなります。
| 失敗しやすいポイント | 起きる問題 | 対策 |
|---|---|---|
| 「検索機能」とだけ説明する | GitHub全体検索と混同される | リポジトリ切り替え用と明記する |
| 権限の説明をしない | 候補に出ない問い合わせが増える | 先にアクセス権の確認方法を案内する |
| リポジトリ名が整理されていない | 検索しても見つけづらい | 命名規則や関連リポジトリ一覧を整備する |
| ブランチ切り替えと混同する | 操作場所を間違える | リポジトリ移動とブランチ切り替えを分けて説明する |
| 使う場面を示さない | 機能が定着しない | レビュー、Issue確認、設定確認など具体例を示す |
特に、GitHubに慣れていないユーザーには「リポジトリ」「Organization」「ブランチ」の違いが分かりにくい場合があります。Repository switcherを案内するときは、リポジトリ間の移動機能であることを最初に伝えると混乱を防げます。
まず確認すべきこと
Repository switcher generally available in global navigation は、GitHubで複数リポジトリを扱う人の移動を短縮するための機能です。使い方は、リポジトリ名の横にある下向き矢印を開き、ダイアログから別リポジトリを検索して選択するだけです。公式情報では、現在のページを離れずにリポジトリ間を移動でき、特に多くのリポジトリを扱う作業で役立つとされています。(The GitHub Blog)
次に取るべき行動はシンプルです。まず自分がよく使うGitHubリポジトリを開き、リポジトリ名の横の下向き矢印が表示されるか確認してください。次に、同じOrganizationやowner namespace内の関連リポジトリを検索して、期待どおりに移動できるか試します。チームで使う場合は、リポジトリ名の命名規則、関連リポジトリ一覧、権限確認の窓口を整理しておくと、Repository switcherを実務に定着させやすくなります。
コメント