Skip to content

GitHub CLI extension for label management

License

Notifications You must be signed in to change notification settings

heaths/gh-label

Repository files navigation

gh label

GitHub CLI extension for issue label management.

Install

Make sure you have version 2.0 or newer of the GitHub CLI installed.

gh extension install heaths/gh-label

Upgrade

The gh extension list command shows if updates are available for extensions. To upgrade, you can use the gh extension upgrade command:

gh extension upgrade heaths/gh-label

# Or upgrade all extensions:
gh extension upgrade --all

Commands

create

Create a label in a repository. You can specify colors with or without a preceeding hash ("#"). If you do not specify a color a random color will be choosen.

gh label create feedback
gh label create p1 --color e00808
gh label create p2 --color "#ffa501" --description "Affects more than a few users"

delete

Delete a label from a repository.

gh label delete p1

edit

Edit a label in a repository. You can specify colors with or without a preceeding hash ("#").

gh label edit general --new-name feedback
gh label edit feedback --color c046ff --description "User feedback"

export

Export labels from the repository to , or stdout if is "-".

gh label export ./labels.csv
gh label export ./labels.json
gh label export --format csv -

import

Import labels into the repository from , or stdin if is "-".

gh label import ./labels.csv
gh label import ./labels.json
gh label import --format csv -

list

List labels in a repository. You can optionally pass a substring to match in the label name or description.

gh label list
gh label list service

License

Licensed under the MIT license.

Portions of this source copied from vilmibm/gh-user-status under the GNU Affero General Public License v3.0.