labman README (GitHub Label Manager)

Updated 07162022-195834


👨🏼‍🔬 github label manager cli

npm npm coveralls

Command line tool for managing issue labels across GitHub repositories.

usage
usage

📦 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.

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.