glab

GitLab CLI (glab) スキル

公式 GitLab CLI である glab を使用して、ターミナルから GitLab の操作を行うためのガイダンスを提供します。

このスキルを使用する場面

ユーザーが次の操作を必要とする場合に呼び出します。

• マージリクエストの作成、レビュー、管理
• GitLab のイシューの操作
• CI/CD パイプラインの監視または実行
• リポジトリのクローンまたは管理
• コマンドラインからの GitLab 操作全般

前提条件

コマンドを実行する前に、glab がインストールされていることを確認します。

glab --version

インストールされていない場合は、ユーザーに知らせ、プラットフォーム別のインストール方法を案内します。

認証のクイックスタート

ほとんどの glab 操作には認証が必要です。

# Interactive authentication
glab auth login

# Check authentication status
glab auth status

# For self-hosted GitLab
glab auth login --hostname gitlab.example.org

# Using environment variables
export GITLAB_TOKEN=your-token
export GITLAB_HOST=gitlab.example.org  # for self-hosted

主なワークフロー

マージリクエストの作成

# 1. Ensure branch is pushed
git push -u origin feature-branch

# 2. Create MR
glab mr create --title "Add feature" --description "Implements X"

# With reviewers and labels
glab mr create --title "Fix bug" --reviewer=alice,bob --label="bug,urgent"

マージリクエストのレビュー

# 1. List MRs awaiting your review
glab mr list --reviewer=@me

# 2. Checkout MR locally to test
glab mr checkout <mr-number>

# 3. After testing, approve
glab mr approve <mr-number>

# 4. Add review comments
glab mr note <mr-number> -m "Please update tests"

イシューの管理

# Create issue with labels
glab issue create --title "Bug in login" --label=bug

# Link MR to issue
glab mr create --title "Fix login" --description "Closes #<issue-number>"

# List your assigned issues
glab issue list --assignee=@me

CI/CD の監視

# Watch pipeline in progress
glab pipeline ci view

# Check pipeline status
glab ci status

# View logs if failed
glab ci trace

# Retry failed pipeline
glab ci retry

# Lint CI config before pushing
glab ci lint

よく使うパターン

リポジトリのコンテキスト外での操作

Git リポジトリ内にいない場合は、リポジトリを指定します。

glab mr list -R owner/repo
glab issue list -R owner/repo

セルフホストの GitLab

すべてのコマンドにホスト名を設定します。

export GITLAB_HOST=gitlab.example.org
# or per-command
glab repo clone gitlab.example.org/owner/repo

自動化とスクリプト

解析には JSON 出力を使用します。

glab mr list --output=json | jq '.[] | .title'

API コマンドの使用

glab api コマンドを使うと、GitLab API に直接アクセスできます。

# Basic API call
glab api projects/:id/merge_requests

# IMPORTANT: Pagination uses query parameters in URL, NOT flags
# ❌ WRONG: glab api --per-page=100 projects/:id/jobs
# ✓ CORRECT: glab api "projects/:id/jobs?per_page=100"

# Auto-fetch all pages
glab api --paginate "projects/:id/pipelines/123/jobs?per_page=100"

# POST with data
glab api --method POST projects/:id/issues --field title="Bug" --field description="Details"

ベストプラクティス

1. コマンドを実行する前に認証を確認します：glab auth status
2. --help を使用してコマンドのオプションを確認します：glab <command> --help
3. MR の説明に「Closes #123」と記載して、MR をイシューに関連付けます
4. プッシュする前に CI 設定をリントします：glab ci lint
5. コマンドが失敗した場合は、リポジトリのコンテキストを確認します：git remote -v

よく使うコマンドのクイックリファレンス

マージリクエスト：

• glab mr list --assignee=@me - 自分に割り当てられた MR
• glab mr list --reviewer=@me - 自分がレビューする MR
• glab mr create - 新しい MR を作成
• glab mr checkout <number> - MR をローカルでテスト
• glab mr approve <number> - MR を承認
• glab mr merge <number> - 承認済みの MR をマージ

イシュー：

• glab issue list - すべてのイシューを一覧表示
• glab issue create - 新しいイシューを作成
• glab issue close <number> - イシューをクローズ

CI/CD：

• glab pipeline ci view - パイプラインを監視
• glab ci status - ステータスを確認
• glab ci lint - .gitlab-ci.yml を検証
• glab ci retry - 失敗したパイプラインを再試行

リポジトリ：

• glab repo clone owner/repo - リポジトリをクローン
• glab repo view - リポジトリの詳細を表示
• glab repo fork - リポジトリをフォーク

段階的な情報開示

コマンドの詳細なドキュメントについては、次を参照してください。

• references/commands-detailed.md - すべてのフラグとオプションを含む、包括的なコマンドリファレンス
• references/quick-reference.md - 簡潔なコマンド早見表
• references/troubleshooting.md - エラーの詳しい事例と解決策

次の場合にこれらのリファレンスを読み込みます。

• ユーザーが特定のフラグやオプションの詳細を必要としている
• 認証または接続の問題をトラブルシューティングしている
• 高度な機能（API、スケジュール、変数など）を使用している

よくある問題のクイック対処法

「command not found: glab」 - glab をインストールするか、PATH を確認してください

「401 Unauthorized」 - glab auth login を実行してください

「404 Project Not Found」 - リポジトリ名とアクセス権限を確認してください

「not a git repository」 - リポジトリに移動するか、-R owner/repo フラグを使用してください

「source branch already has a merge request」 - glab mr list を使用して既存の MR を確認してください

詳しいトラブルシューティングについては、references/troubleshooting.md を読み込んでください。

注意事項

• glab は Git リモートからリポジトリのコンテキストを自動検出します
• ほとんどのコマンドには、ブラウザーで開く --web フラグがあります
• スクリプトや自動化には --output=json を使用してください
• 複数の GitLab アカウントを同時に認証できます
• コマンドは Git の設定と現在のリポジトリのコンテキストに従います