GitHub CLI

GitHub CLI

GitHub CLI（gh CLI）は、コマンドライン上で GitHub を操作するためのツールです。プルリクエスト、Issue、その他の GitHub の概念を、git やコードを扱っているのと同じターミナルに持ち込みます。

重要

Linux パッケージリポジトリ向けの GitHub CLI の PGP 署名キーローテーションは 2026 年 9 月 5 日に有効になります。パッケージのインストールや更新で問題が発生しているユーザーは、公開のお知らせで解決策を確認できます。

GitHub CLI は GitHub.com、GitHub Enterprise Cloud、およびサポートされている GitHub Enterprise Server のバージョンのユーザーが利用でき、macOS、Windows、Linux に対応しています。

ドキュメント

インストール方法は以下を参照してください。使用方法についてはマニュアルをご覧ください。

エージェントスキル

コーディングエージェントから gh を操作するためのエージェントスキルが利用可能です。組み込みの gh skill コマンドでインストールまたは更新できます。

# Install the skill (user scope recommended)
gh skill install cli/cli gh --scope user

# Update the skill after a `gh` release
gh skill update gh

コントリビューション

何かおかしいと感じたり、不足している機能があると思われる場合は、コントリビューションページをご確認ください。そこには、フィードバックの共有方法、ツールをローカルでビルドする方法、プロジェクトへのプルリクエストの送信方法に関する手順が記載されています。

Hubber の方で、CLI に新しいコマンドを追加することに関心がある場合は、内部コントリビューションに関するドキュメントをご覧ください。

インストール

macOS

• Homebrew
• [リリースページ][]にあるコンパイル済みバイナリ

その他の macOS 向けパッケージやインストーラーについては、コミュニティサポートのドキュメントをご覧ください。

Linux & Unix

• Debian、Raspberry Pi、Ubuntu
• Amazon Linux、CentOS、Fedora、openSUSE、RHEL、SUSE
• [リリースページ][]にあるコンパイル済みバイナリ

その他の Linux & Unix 向けパッケージやインストーラーについては、コミュニティサポートのドキュメントをご覧ください。

Windows

• WinGet
• [リリースページ][]にあるコンパイル済みバイナリ

その他の Windows 向けパッケージやインストーラーについては、コミュニティサポートのドキュメントをご覧ください。

ソースからのビルド

GitHub CLI をソースからビルドする方法については、こちらをご覧ください。

GitHub Codespaces

codespace に GitHub CLI を追加するには、devcontainer ファイルに以下を追加します。

"features": {
  "ghcr.io/devcontainers/features/github-cli:1": {}
}

GitHub Actions

GitHub ホストランナーには GitHub CLI がプリインストールされており、毎週更新されます。

特定のバージョンが必要な場合は、GitHub Actions ワークフローで上記の macOS、Linux & Unix、または Windows の手順に基づいてインストールする必要があります。

プリインストールされているすべてのツールについては、actions/runner-imagesをご覧ください。

バイナリの検証

v2.93.0 以降、gh のリリースはイミュータブルリリースとして公開されています。詳細については、イミュータブルリリースを参照してください。

バージョン 2.50.0 以降、gh は Build Provenance Attestation を生成しており、元の GitHub リポジトリ、git リビジョン、および使用されたビルド手順まで暗号学的に検証可能なペーパートレイルをたどることができます。ビルド来歴の証明は署名されており、PKI には Public Good Sigstore を利用しています。

ダウンロードしたリリースを検証する一般的な方法は 2 つあり、gh がすでにインストールされているかどうかによって異なります。gh がインストールされていれば、新しいリリースの検証は簡単です。

• オプション 1: gh がすでにインストールされている場合に gh を使用する:

  $ gh at verify -R cli/cli gh_2.62.0_macOS_arm64.zip
  Loaded digest sha256:fdb77f31b8a6dd23c3fd858758d692a45f7fc76383e37d475bdcae038df92afc for file://gh_2.62.0_macOS_arm64.zip
  Loaded 1 attestation from GitHub API
  ✓ Verification succeeded!
  
  sha256:fdb77f31b8a6dd23c3fd858758d692a45f7fc76383e37d475bdcae038df92afc was attested by:
  REPO     PREDICATE_TYPE                  WORKFLOW
  cli/cli  https://slsa.dev/provenance/v1  .github/workflows/deployment.yml@refs/heads/trunk
  

• オプション 2: Sigstore の cosign を使用する:

  これを実行するには、ダウンロードしたリリースの attestation をダウンロードし、cosign を使用してダウンロードしたリリースの真正性を検証します。

  $ cosign verify-blob-attestation --bundle cli-cli-attestation-3120304.sigstore.json \
        --new-bundle-format \
        --certificate-oidc-issuer="https://token.actions.githubusercontent.com" \
        --certificate-identity="https://github.com/cli/cli/.github/workflows/deployment.yml@refs/heads/trunk" \
        gh_2.62.0_macOS_arm64.zip
  Verified OK
  

hub との比較

長年にわたり、hub は非公式の GitHub CLI ツールでした。gh は、根本的に異なる設計で公式の GitHub CLI ツールがどのようなものになり得るかを探求するのに役立つ新しいプロジェクトです。両方のツールは GitHub をターミナルにもたらしますが、hub は git へのプロキシとして動作し、gh はスタンドアロンのツールです。詳しくは、より詳細な説明をご覧ください。