23 labels · 5 categories · AI-powered

GitHub Labels
Template

A curated set of GitHub labels for any project — apply them all with a single CLI command, or generate custom labels with AI.

Following the Clean Labels convention by WG Tech Labs · Powered by GitHub Copilot

$ npx github-labels-template apply

Features

Everything you need to standardize labels across your projects

🏷️

23 Curated Labels

Organized across 5 categories — type, status, community, resolution, and area. Covers every workflow need.

🚀

One Command Setup

Run ghlt apply and all labels are created. Filter by --category or --label, or skip labels with --exclude.

🔀

Migrate Command

Clean slate in one command. ghlt migrate wipes all existing labels and applies the full template.

📋

List Command

Inspect any repo's labels at a glance. ghlt list shows every label with its color and description.

🔍

Auto-Detect Repo

Automatically detects the current repository from your git remote. No need to specify --repo.

🔄

Smart Conflict Handling

Skips existing labels by default. Use --force to update them to match the template.

Pre-Flight Checks

Validates that gh CLI is installed and authenticated before doing anything.

📊

Clear Output

Color-coded status for every label — created, updated, skipped, or failed — with a summary report.

🧹

Wipe Command

Remove all or specific labels with ghlt wipe. Use --label or --category for targeted removal.

🌐

Dual Runtime

Works with both npx and bunx. Install globally or run on-demand.

AI-Powered Label Generator

Powered by GitHub Copilot SDK

Create custom labels that perfectly follow the Clean Labels convention. Describe what you need, and AI generates suggestions with proper naming, colors, and descriptions.

  • Generate labels following the Clean Labels convention format
  • Interactive pick, refine with feedback, or regenerate suggestions
  • Saves to labels-custom.json for reuse across repos
  • Choose your preferred Copilot model with --model
  • Optionally apply generated labels directly to your repo
Read the Docs →
ghlt generate
$ ghlt generate

? Select a category: community
? Describe the label you need:
  Label for sponsored contributors

  Generating suggestions...

  1. sponsor         ff6b6b
     [Community] Sponsored contributor or backer [issues]

  2. sponsored-dev  9b59b6
     [Community] Developer with active sponsorship [PRs]

  3. backer         27ae60
     [Community] Financial backer of the project [issues]

? Pick a label: sponsor

✓ Saved to labels-custom.json
✓ Applied to warengonzaga/my-project

The Label Set

23 labels designed to cover every project workflow

Type

bug enhancement documentation refactor performance security

Status

blocked needs triage awaiting response ready

Community

good first issue help wanted maintainer only hacktoberfest hacktoberfest-accepted

Resolution

duplicate invalid wontfix

Area

core interface data infra testing

Clean Labels

A standardized labeling convention for GitHub repositories. Every label follows a consistent format with name, color, and structured description — designed for clarity and consistency across any project.

name · color · [Category] Description [scope]

Where scope is [issues], [PRs], or [issues, PRs]

Quick Start

Get up and running in seconds

Apply labels
# Apply all labels to current repo
ghlt apply

# Apply by category
ghlt apply --category type

# Apply specific labels
ghlt apply --label "bug,enhancement"

# Apply all except certain labels
ghlt apply --exclude "bug,enhancement"

# Include AI-generated labels
ghlt apply --custom
List & Wipe
# List all labels on the current repo
ghlt list

# List labels on a specific repo
ghlt list --repo owner/repo

# Remove specific labels
ghlt wipe --label "bug,enhancement"

# Remove an entire category
ghlt wipe --category type
Generate with AI
# Interactive AI generator
ghlt generate

# Pre-select a category
ghlt generate --category type

# Use a specific model
ghlt generate --model claude-sonnet-4
Migrate
# Clean slate: wipe + apply
ghlt migrate

# Skip confirmation
ghlt migrate --yes

# Include custom labels
ghlt migrate --custom
Install globally
# npm
npm install -g github-labels-template

# bun
bun install -g github-labels-template

# Then use anywhere
ghlt apply