👨🏼🔬 github label manager cli
Command line tool for managing issue labels across GitHub repositories.
📦 Installation
Installation is optional, as you can run this package with npx.
npm install labman --global
🥑 Usage
If you have labman installed globally you can run it as shown below.
labman --help
Alternatively, you can run it with npx.
npx labman --help
👨🏼🏫 Commands
login
Validates and stores your GitHub personal access token.
Options
| Name | Description | Default |
|---|---|---|
username |
GitHub username. | |
token |
GitHub personal access token with repo scope. |
|
--force, -f |
Overwrite existing login. | false |
Examples
Login as bradgarropy with a personal access token.
labman login bradgarropy 123456
Login as gabygarropy, overwriting the bradgarropy login.
labman login gabygarropy 456789
labman
Copies labels from one repository to another.
The source and destination can be provided in two ways.
owner/repo, likebradgarropy/labman-clirepo, likelabman-cli
If an owner is not specified, labman will assume the username you provided during login.
If labels is not provided, labman will copy all labels from source to destination.
Options
| Name | Description | Default |
|---|---|---|
source |
GitHub repository. | |
destination |
GitHub repository. | |
labels |
Space separated list of label names to copy. | [] |
--clobber, -c |
Remove all labels from destination before copying source labels. |
false |
Examples
Copy all labels from bradgarropy/label-source to bradgarropy/label-destination.
labman bradgarropy/label-source bradgarropy/label-destination
Delete all labels from bradgarropy/label-destionation, then copy all labels from bradgarropy/label-source to bradgarropy/label-destination.
labman bradgarropy/label-source bradgarropy/label-destination --clobber
Copy only the bug and todo labels from bradgarropy/label-source to bradgarropy/label-destination.
labman bradgarropy/label-source bradgarropy/label-destination bug todo
Use the shorthand method for providing source and destination repositories.
labman login bradgarropy 123456
labman label-source label-destination
logout
Removes your GitHub personal access token.
Examples
labman logout
❔ Questions
If you have any trouble, definitely open an issue and I'll take a look.
If all else fails, you can ask me directly on Twitter or my AMA.