ghlabels

A tool to synchronize labels on GitHub repositories sanely.

It uses the same credentials as hub to access github repositories. In fact, it uses the same library as hub so if you have multiple credentials with hub and expect to be able to select between them, ghlabels will offer the same prompts. If you do not have hub setup, it will prompt for the credentials the same way hub does. You will need to set $GITHUB_HOST before running a command for the first time if you are using a custom GitHub enterprise setup and have not used it already with hub. After that, ghlabels will prompt you to select between hosts.

Install

go get -u nhooyr.io/ghlabels

Usage

ghlabels uses a JSON file that looks like this and represents the labels for a given repository:

[
    {
        "name": "blocked",
        "description": "",
        "color": "032e70"
    },
    {
        "name": "good first issue",
        "description": "",
        "color": "e7dff5"
    },
    {
        "name": "p1",
        "description": "",
        "color": "df0000"
    },
    {
        "name": "p2",
        "description": "",
        "color": "ff7474"
    },
    {
        "name": "p3",
        "description": "",
        "color": "ffabab"
    },
    {
        "name": "p4",
        "description": "",
        "color": "ffe3e3"
    }
]

You may create and edit a file manually or have ghlabels create this file for you via

ghlabels pull <org>/<repo> > labels.json

The above command will create a labels.json file in the current directory for the labels on <org>/<repo>

You can push this to an entire organization's repos (or a single repo) via

ghlabels push <org>[/<repo>] < labels.json 

Its important to note that this will not delete labels not included in the labels.json. This is to allow individual repos to create their own custom labels.

You can delete labels across entire organizations or repos via the delete subcommand.

ghlabels delete <org>[<repo>] [<label>]

If you do not provide a label, all the labels of the organization will be deleted.

You can rename labels across entire organizations or repos via the rename subcommand.

ghlabels rename <owner>[/<repo>] <old_name> <new_name>