github-label

Node command-line tool used to create or remove GitHub labels. Predefined labels are available in the presets folder. You can also create and use your own labels with JSON.

Installation and Setup

npm install -g github-label

Authentication with GitHub Access Token

Use this method if don't want to type your username and password.

Create a Personal access token on GitHub with the repo and public_repo permissions enabled. Then add the following environment variable in your .bashrc (Linux) or .bash_profile (Mac).

export GITHUB_LABEL_TOKEN='REPLACE THIS WITH YOUR TOKEN'

Usage Examples

  Usage: github-label [options]

  Options:

    -h, --help            output usage information
    -V, --version         output the version number
    -p, --preset [value]  Specify a label preset.
    -j, --json [value]    Specify your own JSON label preset.
    -r, --remove          Remove a GitHub label preset.
    -R, --remove-all      Removes all labels.

--

Output repository labels

github-label 'codenameyau/github-label'

--

Create labels with one of the available presets

github-label 'codenameyau/github-label' -p priority

--

Remove label preset

github-label 'codenameyau/github-label' -p priority -r

--

Create labels by specifying your own custom JSON preset

github-label 'codenameyau/github-label' -j 'path-to/preset.json'

--

Remove custom label preset

github-label 'codenameyau/github-label' -j 'path-to/preset.json' -r

--

Remove all labels

github-label 'codenameyau/github-label' -R