You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
:flags:Edit git labels from the command line using **`git-labelmaker`**! You can easily add or remove git-labels, making it easier for your project to adhere to a sane labelling scheme.
1
+
## :flags:git-labelmaker
2
+
Edit GitHub labels from the command line using **`git-labelmaker`**! You can easily add or remove GitHub labels, making it easier for your projects to adhere to a sane labelling scheme.
3
3
4
4
### Install
5
5
@@ -11,26 +11,36 @@ npm i -g git-labelmaker
11
11
12
12
### Usage
13
13
14
-
Using this bad boy is a breeze. First `cd` into your repository and then run the command without any arguments:
14
+
Using this bad boy is a breeze. First `cd` into your git repository, run the command and follow the prompts!
15
15
16
16
```
17
17
git-labelmaker
18
18
```
19
19
20
-
You'll then be able to add or remove labels for the repository you are in.
20
+
#### Token
21
21
22
-
If it's the first time running the command, you will be prompted for a GitHub token, which you can [generate over here](https://github.com/settings/tokens).
22
+
If it's the first time running it, you will be prompted for a GitHub token, which you can [generate over here](https://github.com/settings/tokens). You can reset your token later, but otherwise `git-labelmaker` will remember it for you.
23
23
24
-
###About
24
+
#### Add Custom Labels
25
25
26
-
`git-labelmaker` is essentially a sugar for the [`git-label`](https://github.com/jasonbellamy/git-label) package written by [**jasonbellamy**](https://github.com/jasonbellamy). It provides a few nice features that make creating custom labels a breeze, such as:
26
+
You can add your own labels one at a time. You will be prompted for your new label's text and color. Include the `#` in front of your 3 or 6 digit hex color. Add as many as you like!
27
27
28
-
- stores your GH token so you don't have to keep whipping it out
29
-
- learns the gh repo name so you don't need to add it to a config
30
-
- removal based on the current labels in the repo
31
-
- wraps the whole thing in pretty [**inquirer.js**](https://github.com/SBoudrias/Inquirer.js/) prompts
28
+
#### Add Labels From Package
29
+
30
+
If you have a labels package in your current directory that you would like to use for adding labels, just supply the path and name of that file. So like if it's at the root of the current directory, just `labels.json`.
31
+
32
+
It must be a valid `.json` file, and must match the expected format. Check out [these really good ones](https://github.com/jasonbellamy/git-label-packages/tree/master/packages) if you need a template.
33
+
34
+
#### Remove Labels
35
+
36
+
You can also remove labels. Just select the ones you want to ditch and :boom: they're gone.
37
+
38
+
> **Related:**
39
+
-[`git-label`](https://github.com/jasonbellamy/git-label) by [**jasonbellamy**](https://github.com/jasonbellamy), which `git-labelmaker` uses to add and remove labels
40
+
-[`git-label-packages`](https://github.com/jasonbellamy/git-label-packages) is a really good set of default packages if you really want to level up your projects
41
+
-[`git-label-faces`](https://github.com/himynameisdave/git-label-faces) is a joke package set that you should totally never use for real
32
42
33
43
---
34
44
35
45
*Created by [Dave Lunny](https://twitter.com/dave_lunny) in the wonderful year of 2016.*
0 commit comments