Skip to content

Latest commit

 

History

History
58 lines (37 loc) · 1.95 KB

README.md

File metadata and controls

58 lines (37 loc) · 1.95 KB

org-labels

NPM Version NPM Downloads Node.js Version

A tool to help manage organization-wide GitHub issue labels.

Installation

$ npm install -g org-labels

Usage

$ org-labels <command>

Requires io.js 1.1.0+ — you can use a node version manager such as nvm to switch node versions easily.

GitHub Security

org-labels uses ghauth for GitHub authentication. The version is fixed, and I have done a rough review of its code.

Commands

  • add <org> <label> <color> - adds a label to all repos.
  • remove <org> <label> - removes a label from all repos.
  • update <org> <label> <color> - updates an existing label for all repos.
  • rename <org> <label> <new> - renames an existing label for all repos.
  • standardize <org> <repo> - reads a config/github_labels.json file from a repo and adds / updates labels on all repos.

color must be a hexadecimal color code without the preceding #.

Both <org> and <repo> may optionally be formatted as <org/repo>.

Options

  • -d --destructive - When enabled, allows standardize to remove labels not found in the config file.

Examples

The following would add a docs issue label with the color d4c5f9 to every repo in repo-utils.

$ org-labels add repo-utils docs d4c5f9

The following would standardize labels in all repo-utils repos using the jshttp labels config.

$ org-labels standardize repo-utils jshttp/style-guide