【ギットハブシーエルアイ】

GitHub CLI とは?

最終更新:
💡 ghコマンドで、GitHubの機能をターミナルへ

ターミナルからGitHubのPull Request、Issue、Actionsなどを操作できる公式ツール。ghコマンドで利用し、認証や必要な権限に応じてGitHubの機能へアクセスする。

📌 このページのポイント
GitHubの機能をコマンドで使う ターミナル gh pr list gh issue list gh run list 一覧を確認する例 GitHub Pull Request Issue Actions 操作 結果 認証と必要な権限に応じて使う git:リポジトリ / gh:GitHubの機能
ghコマンドでPull Request・Issue・Actionsの一覧を確認する例。矢印は操作要求と結果を表す。すべての操作がCLIだけで完結するという保証ではない。
ひよこ ひよこ
PRを作るたびにブラウザでGitHubを開くのが面倒なんだけど…
ペンギン先生 ペンギン先生
gh pr createで、タイトルや本文を入力してPull Requestを作れるよ。認証やリポジトリなどの条件が必要で、手元のブランチが未送信ならpush先を尋ねる場合もある。コマンド一つだけで、どの状況でも作れるという意味ではないんだ。
ひよこ ひよこ
PR以外にもできることあるの?
ペンギン先生 ペンギン先生
Issueやリポジトリ、Releaseの操作、Actionsの実行状況の確認などができるよ。ワークフローを手動実行するgh workflow runには、対象がworkflow_dispatchに対応している必要がある。GitHubのすべての機能を必ずCLIだけで完結できるとは限らないんだ。
ひよこ ひよこ
gh apiって何ができるの?
ペンギン先生 ペンギン先生
GitHubのREST APIやGraphQLに、認証付きHTTPリクエストを送って結果を表示できるよ。必要な権限や対象のリソースは認証情報による。自動化でも、使うAPIと認証の条件を確認するんだ。
ひよこ ひよこ
拡張機能の例も、そのまま使える?
ペンギン先生 ペンギン先生
拡張や関連ツールは、現在の対応状況を確認する必要があるよ。たとえば旧gh-copilot拡張は2025年10月25日に廃止すると公式に案内された。古い記事の拡張例と、現在のGitHub Copilot CLIなどを区別して読むんだ。
ひよこ ひよこ
認証ってどうするの?
ペンギン先生 ペンギン先生
gh auth loginで対話的に設定でき、標準ではブラウザによる認証フローを使うよ。自動化では環境変数のトークンを使う方法もある。SSHキーの確認や作成の案内は、選んだGitの接続方式などによるんだ。
ひよこ ひよこ
gitコマンドは使わなくなるの?
ペンギン先生 ペンギン先生
gitはローカルやリモートのGitリポジトリを扱うコマンドだよ。ghはGitHub固有のPull Requestなどを操作するためのツールで、役割が違う。組み合わせて使えるんだ。
ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「GitHub CLI」って出てきたら「ghコマンドでGitHubを操作する公式ツール」と思えばだいたいOK!
📖 おまけ:英語の意味
「GitHub Command Line Interface」 = GitHubコマンドラインインターフェース
💬 ghコマンドで使える、GitHub公式のCLIツールだよ。GitHubの機能をターミナルに持ってきた感じだね

参考資料

← 用語集にもどる