GITHUB CLI GUIDE

GitHub CLI編

ghコマンドで効率化

⌘

ターミナルから
GitHub操作

⚡

ブラウザ不要
高速ワークフロー

🔧

スクリプトで
自動化可能

→ キーで次へ

この編の全体像

ゴール: ghコマンドでブラウザを開かずにGitHub操作を完結させ、開発スピードを上げる

1

セットアップ

インストールと認証
→ まず使える状態にする

2

基本操作（Repo/Issue/PR）

日常的なGitHub作業をターミナルから実行
→ 日常的なGitHub作業をターミナルから実行

3

応用操作（Actions/Release）

CI/CDやリリースもCLIで管理
→ CI/CDやリリースもCLIで管理

4

カスタマイズ

エイリアスとAPI操作
→ 自分だけのワークフローを作る

5

スクリプト連携

シェルスクリプトに組み込む
→ 完全自動化

GitHub CLI とは？

ブラウザ操作

1. ブラウザを開く
2. GitHubにログイン
3. リポジトリを探す
4. ボタンをクリック
5. フォームを埋める
⏱ 約2〜3分

gh コマンド

        $ gh pr create --fill

        ✔ 完了

        ⏱ 約5秒

gh は GitHub公式のCLIツール。Issue作成、PR操作、Actions確認、Release公開まで全てターミナルから実行できる。

インストール

Mac

brew install gh

Linux (Debian/Ubuntu)

sudo apt install gh

Windows

winget install GitHub.cli

Terminal — install gh

認証 — gh auth login

初回だけ必要。GitHubアカウントとCLIを紐付ける。

Terminal — gh auth login

認証フロー

🌐

① GitHub.com

アカウントを選択

▼

🔓

② ブラウザ認証

ワンタイムコードを入力

▼

✅

③ CLI紐付け完了

トークン自動保存

リポジトリ操作

Terminal — gh repo

📖 your-username/my-app

Public

The library for web and native user interfaces

⭐ 232,456 🍴 47,891 ● JavaScript

About

📝 MIT License 👀 6,702 watching

Operations

gh repo create gh repo clone gh repo view

Opening in browser...

Issue操作

Terminal — gh issue

Issue Card

○ 検索機能の追加 #13

enhancement

ユーザーが商品を検索できる機能

your-username opened 0 comments

Open Issues

#12 ダークモード対応2h

#11 ログインエラー修正5h

#10 README更新1d

#9 パフォーマンス改善2d

PR操作 — フルフロー

Terminal — gh pr (full workflow)

PR Flow

🌿 Branch

feature/search

▼

📤 Pull Request

#14 検索機能を追加

▼

🔍 Review

コードレビュー

▼

✔ Merge

Squash and merge

PRレビュー

Terminal — gh pr review

Review Status

○ CI Checks

○ build ○ test ○ lint

▼

📝

Changes requested

バリデーションを追加してください

▼

✅

Approved

LGTM! 検索ロジックが綺麗です

Actions操作

CI/CDの状態をターミナルからリアルタイム監視

Terminal — gh run

Pipeline Status

○

Build

25s

→

○

Test

1m42s

→

○

Deploy

running

Recent Runs

✔ feat: add search2m ago

✔ fix: login error1h ago

✖ test: update snapshots2h ago

Release操作

Terminal — gh release

Release Card

🏷 v1.2.0 Latest

検索機能追加

What's New

- 検索機能を追加

- パフォーマンス改善

- バグ修正

Assets

📦 app.zip (2.4 MB)

v1.1.02 weeks ago

v1.0.01 month ago

エイリアス — ショートカット登録

毎回入力

        $ gh pr checkout 42

        $ gh issue list --label bug

        $ gh pr list --state merged

エイリアス活用

        $ gh co 42

        $ gh bugs

        $ gh merged

Terminal — gh alias

API操作 — gh api

GitHub REST / GraphQL APIを認証付きで直接呼べる

Terminal — gh api

API Response

GET /repos/your-username/my-app

            {

              "full_name": "your-username/my-app",

              "private": false,

              "stargazers_count": 42,

              "forks_count": 7,

              "open_issues_count": 3

            }

Supported APIs

REST GraphQL --jq filter

jq filtering

            --jq .stargazers_count

            → 42

スクリプト連携

シェルスクリプトやjqと組み合わせて自動化

Terminal — gh + shell scripting

Automation Pipeline

📡 gh api

GitHub APIからデータ取得

▼

🔧 jq / shell

データを整形・フィルタリング

▼

✔ Result

自動処理結果を出力

Use Cases

▸ PR一覧のタイトル抽出 ▸ 古いIssueの一括クローズ ▸ 自動PR作成スクリプト ▸ リポジトリ統計の集計

まとめ — よく使うコマンド一覧

基本操作

gh auth login	認証
gh repo create	リポジトリ作成
gh repo clone	クローン
gh issue create	Issue作成
gh issue list	Issue一覧
gh pr create	PR作成
gh pr list	PR一覧
gh pr checkout	PRのブランチに切替
gh pr merge	PRをマージ

応用操作

gh pr review	PRレビュー
gh pr diff	PRの差分確認
gh run list	Actions一覧
gh run watch	実行をリアルタイム監視
gh release create	リリース作成
gh alias set	ショートカット登録
gh api	APIを直接呼ぶ
gh search repos	リポジトリ検索
gh extension	拡張機能管理

まずは gh auth login で認証して、gh pr create から使い始めよう！

Appendix: コマンドリファレンス

コマンド	説明
brew install gh	MacにGitHub CLIをインストールする（Homebrew）
gh --version	GitHub CLIのバージョンを確認する
gh auth login	GitHubアカウントで認証する（初回のみ）
gh auth status	現在の認証状態を確認する
gh repo create	新しいリポジトリを作成する
gh repo clone	リポジトリをクローンする
gh repo view	リポジトリの情報を表示する
gh repo view --web	リポジトリをブラウザで開く
gh issue list	Issueの一覧を表示する
gh issue create	新しいIssueを作成する
gh issue view <number>	Issueの詳細を表示する
gh issue close <number>	Issueをクローズする
gh pr create	Pull Requestを作成する
gh pr list	Pull Requestの一覧を表示する
gh pr checkout <number>	PRのブランチをチェックアウトする
gh pr merge	Pull Requestをマージする
gh pr diff <number>	PRの差分を表示する
gh pr checks <number>	PRのCI/CDチェック結果を表示する
gh pr review --approve	PRを承認する
gh pr review --request-changes	PRに変更を要求する
gh run list	GitHub Actionsの実行一覧を表示する
gh run view <id>	特定のワークフロー実行の詳細を表示する
gh run watch	実行中のワークフローをリアルタイム監視する
gh release list	リリースの一覧を表示する
gh release create <tag>	新しいリリースを作成する
gh release view --web	リリースをブラウザで開く
gh alias set <name> '<cmd>'	コマンドのショートカット（エイリアス）を登録する
gh alias list	登録済みエイリアスの一覧を表示する
gh api <endpoint>	GitHub REST APIを認証付きで直接呼び出す
gh api graphql -f query='...'	GitHub GraphQL APIを呼び出す
gh api ... --jq <expr>	APIレスポンスをjq式でフィルタリングする
gh pr list --json ... --jq '...'	PR情報をJSON出力し、jqでパイプ処理する
gh search repos	GitHub上のリポジトリを検索する
gh extension	GitHub CLIの拡張機能を管理する