3分学習!エンジニア向け GitHub CLI (gh) 完全ガイド:実務で使えるコマンド集

目次

はじめに

GitHub CLIとは?

GitHub CLI(gh)は、GitHub公式のコマンドラインツールで、リポジトリの管理、IssueやPull Request(PR)の操作、ワークフローの自動化をコマンドライン上で行うことができます。

主な特徴

  • GitHubの操作をブラウザに移動せずに完結できる
  • 自動化やスクリプトとの連携が容易
  • CI/CDやチーム開発の効率化が可能

なぜGitHub CLIを使うのか?

  • 作業効率の向上:マウス操作なしで高速なGitHub管理が可能
  • コマンドの一貫性:GitやGitHubの操作を統一的に扱える
  • 自動化の実現:スクリプトとの連携でワークフローを自動化
  • チーム開発の効率化:統一された運用でメンバー間の負担を軽減

GitHub CLIのインストールと初期設定

各OSでのインストール方法

macOS

brew install gh

Ubuntu

sudo apt update && sudo apt install gh

Windows

winget install --id GitHub.cli

初期設定

gh auth login

基本的な認証と設定

認証方法の選択

  • ブラウザ認証(推奨)
gh auth login
  • トークン認証
gh auth login --with-token <TOKEN>
  • SSH認証
gh auth login --ssh-key ~/.ssh/id_rsa.pub

環境変数の設定

export GH_HOST="github.com"

実務でよく使うコマンド

リポジトリ操作

gh repo clone <リポジトリ名>
gh repo view --web

Issue管理

gh issue list
gh issue create --title "バグ修正" --body "詳細な説明"

Pull Request管理

gh pr list
gh pr create --title "新機能追加" --body "詳細な説明"
gh pr merge --auto --squash

チーム開発での活用方法

コードレビューの効率化

  • PRの一括レビュー
gh pr review --approve <PR番号>
  • レビューコメントの管理
gh pr comment <PR番号> --body "修正をお願いします"

チーム内での共有

  • コマンドの共有
  • ワークフローの標準化

CI/CDでの活用

GitHub Actionsとの連携

gh workflow list
gh workflow run <ワークフロー名>

自動化スクリプトの例

#!/bin/bash
if gh pr status | grep "needs review"; then
    gh pr review --approve
fi

トラブルシューティング

よくある問題と解決方法

  • 認証エラー gh auth refresh
  • 権限エラー

gh auth status

- **ネットワークエラー**
```sh
gh auth logout && gh auth login

まとめ

メリット

  • 作業効率の向上
  • 自動化の実現
  • チーム開発の効率化

今後の展望

  • 新機能の予定
  • コミュニティの動向

GitHub CLIを活用して、より効率的な開発を実現しましょう!

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次