gh-labelx

Creates issue labels on GitHub idempotently through HashiCorp Terraform.

Features

• Idempotent: Apply twice, changes once.
• Easy: No configuration required if you are using gh CLI.
• Simple: Just write a simple YAML manifest to create many labels at once.
• Extensible: Requests to GitHub are powered by Terraform. You can customise additional labels or properties using hooks after generation.

Prerequisites

gh-labelx requires HashiCorp Terraform. On macOS, you can install them via Homebrew:

brew install terraform

For other platforms, refer the official documentation: https://www.terraform.io/downloads

Getting started

gh extension install siketyan/gh-labelx

Usages

First, write your manifest in YAML format:

---
labels:
  - name: feature
    color: '0000FF'
  - name: fix
    color: 'FF0000'
  - name: refactor
    color: '00FF00'

Check your manifest is correct and can be applied to GitHub:

gh labelx -o <owner> -r <repo> plan -f <file>

Now apply to your GitHub repository:

gh labelx -o <owner> -r <repo> apply -f <file>

It's easy!