glab-label

glab label

プロジェクトおよびグループレベルでラベルを管理します。

クイックスタート

# Create project label
glab label create --name bug --color "#FF0000"

# Create group label
glab label create --group my-group --name priority::high --color "#FF6B00"

# List labels
glab label list

# Update label
glab label edit bug --color "#CC0000" --description "Software defects"

# Delete label
glab label delete bug

判断：プロジェクトレベルとグループレベルのラベル、どちらを使うべきですか？

Where should this label live?
├─ Used across multiple projects in a group
│  └─ Group-level: glab label create --group <group> --name <label>
└─ Specific to one project
   └─ Project-level: glab label create --name <label>

グループレベルのラベルを使うケース：

• グループ内のすべてのプロジェクトで一貫したラベルを使いたい
• 組織全体のワークフローを管理する
• 例：priority::high、type::bug、status::blocked
• 重複を減らし、一貫性を確保できます

プロジェクトレベルのラベルを使うケース：

• ラベルがプロジェクト固有のワークフローに対応している
• チームが独自のラベルを管理したい
• 例：needs-ux-review、deploy-to-staging、legacy-code

一般的なワークフロー

ラベル体系の作成

優先度ラベルを設定する（グループレベル）：

glab label create --group engineering --name "priority::critical" --color "#FF0000"
glab label create --group engineering --name "priority::high" --color "#FF6B00"
glab label create --group engineering --name "priority::medium" --color "#FFA500"
glab label create --group engineering --name "priority::low" --color "#FFFF00"

種類ラベルを設定する（グループレベル）：

glab label create --group engineering --name "type::bug" --color "#FF0000"
glab label create --group engineering --name "type::feature" --color "#00FF00"
glab label create --group engineering --name "type::maintenance" --color "#0000FF"

プロジェクト固有のラベルを管理する

ワークフローラベルを作成する：

glab label create --name "needs-review" --color "#428BCA"
glab label create --name "ready-to-merge" --color "#5CB85C"
glab label create --name "blocked" --color "#D9534F"

一括操作

確認用にすべてのラベルを一覧表示する：

glab label list --per-page 100 > labels.txt

GitLab のページネーションレスポンスに合計件数が含まれる場合、テキストヘッダーには現在のページで返された件数ではなく、実際のラベル総数が表示されます。追加のページを取得するには --page と --per-page を使用してください。表示された合計が表示行数より多いからといって、すべてのラベルが表示されていると判断しないでください。

廃止予定のラベルを削除する：

glab label delete old-label-1
glab label delete old-label-2

関連スキル

ラベルの使用：

• イシューにラベルを適用する方法については、glab-issue を参照してください
• マージリクエストにラベルを適用する方法については、glab-mr を参照してください
• スクリプト：ラベルを一括適用するには scripts/batch-label-issues.sh を使用します

構造化出力

glab label get は、エージェントによる自動化に便利な構造化出力として --output json / -F json をサポートしています。

# Get a label with JSON output
glab label get <label-id> --output json
glab label get <label-id> -F json

コマンドリファレンス

コマンドの詳細なドキュメントとすべてのフラグについては、references/commands.md を参照してください。

使用可能なコマンド：

• create - ラベルを作成します（プロジェクトまたはグループ）
• list - ラベルを一覧表示します
• edit - ラベルのプロパティを更新します
• delete - ラベルを削除します
• get - 単一のラベルの詳細を表示します