Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heaths/gh-label
GitHub CLI extension for label management
https://github.com/heaths/gh-label
cli gh-extension
Last synced: 18 days ago
JSON representation
GitHub CLI extension for label management
- Host: GitHub
- URL: https://github.com/heaths/gh-label
- Owner: heaths
- License: mit
- Created: 2021-08-25T00:33:49.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-01-20T08:47:18.000Z (almost 3 years ago)
- Last Synced: 2024-10-06T15:22:55.467Z (29 days ago)
- Topics: cli, gh-extension
- Language: Go
- Homepage:
- Size: 31.9 MB
- Stars: 56
- Watchers: 3
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-gh-cli-extensions - **label** - Extension for issue label management. (Github)
- jimsghstars - heaths/gh-label - GitHub CLI extension for label management (Go)
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.
```bash
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:
```bash
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.
```bash
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.
```bash
gh label delete p1
```
### edit
Edit a label in a repository.
You can specify colors with or without a preceeding hash ("#").
```bash
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 "-".
```bash
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 "-".
```bash
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.
```bash
gh label list
gh label list service
```
## License
Licensed under the [MIT](LICENSE.txt) license.
Portions of this source copied from [vilmibm/gh-user-status](https://github.com/vilmibm/gh-user-status/tree/533285348c0354064d79053da39aa75f17b5c55f) under the [GNU Affero General Public License v3.0](https://github.com/vilmibm/gh-user-status/blob/533285348c0354064d79053da39aa75f17b5c55f/LICENSE).
[GitHub CLI]: https://github.com/cli/cli
[newer]: https://github.com/cli/cli/releases/latest