Debian 13 (UTM) への GitHub CLI (gh) インストールガイド

本書は、UTM 上で動作する Debian 13 に gh コマンドをインストールする手順をまとめたものです。

推奨方法: 公式 GitHub APT リポジトリの使用

公式リポジトリを使用することで、GitHub から直接最新バージョンと更新を入手することができます。

1. システムの更新

作業を開始する前に、パッケージリストを更新してください。

sudo apt update

2. 依存関係のインストール

キーのダウンロードと管理に必要なツールをインストールします。

sudo apt install -y curl gpg

3. GitHub 公式 GPG キーの追加

GPG キーをダウンロードし、システムキーリングに追加します。

# キーリング用ディレクトリが存在しない場合は作成
sudo mkdir -p -m 755 /etc/apt/keyrings

# キーをダウンロードして dearmor 化 (バイナリ形式に変換)
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/githubcli-archive-keyring.gpg

# パーミッションの設定
sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg

4. GitHub CLI リポジトリの追加

リポジトリのソースリストを apt に追加します。

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | \
sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null

5. gh のインストール

パッケージインデックスを再度更新し、パッケージをインストールします。

sudo apt update
sudo apt install -y gh

6. インストールの確認

gh が正しくインストールされたか確認します。

gh --version

認証

インストール後、以下のコマンドで GitHub アカウントによる認証を行ってください：

gh auth login

対話型のプロンプトに従ってログインします（通常は Web ブラウザ経由、または認証トークンを使用）。

Projects の利用（権限の追加）

GitHub Projects を CLI から操作する場合（gh project list など）、追加の権限（スコープ）が必要です。 デフォルトのログインではこれらは含まれていないため、以下のコマンドで権限を追加してください：

gh auth refresh -s project

• project: プロジェクトの閲覧および編集（読み書き）権限を付与します。
• このコマンドを実行すると、再度ブラウザでの認証が求められます。

参考文献

• GitHub CLI 公式インストールガイド (Linux)