github labels

This repo is used to easily sync and manage github labels based on a yml file.

Prerequisites

• Create a Github personal access token with a scope of repo (full control of private repositories)
• Have node/npm installed.

Installation

Ensure that your node bin directory is in your path.

npm install
npm link

Usage

The labels that will be created are in labels.yml. Any existing labels that are setup on the repos will be removed if they do not exist in labels.yml. The repos that will be processed exist in organization as defined by org in the script.

• Run on a single repo:

  gh-labels -o <repo-owner> -t <gh-token> -r <repo-name>

• Run on all repos owned by an owner: (Cannot grab private repos of a user).

  gh-labels -o <repo-owner> -t <gh-token>

• Run on all repos owned by all owners listed:

  gh-labels --owners <repo-owner-1> <repo-owner-2> -t <gh-token>

• Run the update script in dry-run mode

  gh-labels -o <repo-owner> -t <gh-token> -r <repo-name> --dry-run

• Run on an enterprise github

  gh-labels -o <repo-owner> -t <gh-token> -r <repo-name> -e "https://<company github url>"