gh-label

README

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.