gh コマンドは、GitHub が公式に提供しているコマンドラインインターフェース(CLI)です。
リポジトリ管理、Issue、Pull Request、Actions、リリース管理などをターミナルから操作できます。
構文(Syntax)
gh <サブコマンド> [オプション]
主なサブコマンド一覧
| サブコマンド | 説明 | 使用例 |
|---|---|---|
repo | リポジトリの作成・管理 | gh repo create myrepo |
issue | Issue の閲覧・作成・管理 | gh issue list |
pr | Pull Request の閲覧・作成・マージ | gh pr create --fill |
release | リリースの作成・表示・削除 | gh release create v1.0.0 |
workflow | GitHub Actions ワークフローを操作 | gh workflow list |
run | GitHub Actions の実行確認 | gh run list |
auth | 認証やログイン | gh auth login |
gist | Gist の管理 | gh gist create file.txt |
api | GitHub API を直接呼び出し | gh api /repos/user/repo |
実行例
GitHub にログイン
gh auth login
(対話形式で GitHub アカウントを認証)
リポジトリを作成
gh repo create myproject --public
Issue を一覧表示
gh issue list
出力例:
#12 Fix login bug bug,help wanted
#15 Add new feature enhancement
Issue を作成
gh issue create --title "New bug" --body "Steps to reproduce..."
Pull Request を作成
gh pr create --base main --head feature-x --title "Add new feature" --body "Implement feature X"
Pull Request をマージ
gh pr merge 123 --squash
リリースを作成
gh release create v1.0.0 build.zip --notes "First release"
ワークフローを確認
gh workflow list
GitHub API を直接利用
gh api /user
エラー例(認証していない場合)
gh issue list
出力例:
gh: Not logged in. Run 'gh auth login' to authenticate
関連コマンド
git: Git の基本コマンド。hub: GitHub 用の旧 CLI(非推奨、gh に統合)。
備考
ghは GitHub 専用 CLI であり、Git 自体のコマンドとは別物。- 認証は OAuth または PAT(Personal Access Token)で行う。
- GitHub Actions の操作(workflow 実行・run 確認)にも対応している。
参考
- GitHub CLI 公式: https://cli.github.com/
- ドキュメント: https://cli.github.com/manual/

コメント