Manage labels on GitHub sanely
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


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.


go get -u


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>