octo-labels v1.5.0

🐙🔖 OctoLabels - GitHub Label Management Tool

OctoLabels is a React-based application built with TypeScript and Vite, designed to streamline GitHub label management. It provides an intuitive UI for visual label comparison and includes CLI scripts to automate label operations, making it an efficient solution for managing labels across repositories.

🔑 Features

• 🖥️ React UI for Label Comparison
  Utilize react-json-view-compare to visually compare label sets and track differences between repositories.

• 📜 GitHub Label Management Scripts
  Automate exporting, adding, and deleting labels using GitHub CLI for streamlined repository management.

• ⚡ Vite-Powered Development
  Enjoy a fast development experience with hot module replacement (HMR) and optimized build times.

• 🏗️ Modular & Configurable Structure
  Easily extend, modify, and manage labels using JSON-based label sets.

📂 Project Structure

📦 octo-labels
├── 📂 src
│   ├── 📝 App.tsx                 # Main React component for label comparison
├── 📂 scripts
│   ├── 🚀 export-github-labels.js  # Exports GitHub labels to JSON
│   ├── 🚀 add-github-labels.js     # Adds labels from JSON to GitHub
│   ├── 🚀 delete-github-labels.js  # Deletes all labels in a repository
│   ├── 🚀 migrate-github-labels.js # Migrates labels from <owner>/<source-repo> to <owner>/<target-repo>
├── 📂 data/                    # JSON files storing label sets
├── 📄 package.json                 # Project metadata & available scripts

🛠️ Installation & Setup

📌 Prerequisites

Before using OctoLabels, ensure you have:

• Node.js (>= 20.x recommended)
• Git installed for version control
• GitHub CLI (gh command-line tool) installed and authenticated (gh auth login)

📥 Install & Initialize

1. Clone the repository:

   git clone https://github.com/0x1ad2/octo-labels
   cd octo-labels

2. Install dependencies:

   npm i --legacy-peer-deps

3. Initialize the project:

   npm run init

   This will export existing GitHub labels and start the development server.

4. Modify labels as needed:

   • Copy default-github-labels.json to new-github-labels.json.
   • Edit the JSON file to adjust labels according to your needs.

5. To start fresh, delete all labels using:

   npm run delete

6. Add the updated labels:

   npm run add -- --filePath path/to/your-labels.json

7. Migrate labels from one repository to another:

   npm run migrate -- --source owner/source-repo --target owner/target-repo

🖥️ Using the CLI

If you prefer to use the CLI directly without cloning the repository, you can run the following commands using npx:

!WARNING
All commands are executed within the repository context. Make sure that you are in the correct directory before running the commands.

1. Display help information:

   npx octo-labels --help

2. Export GitHub labels to a JSON file:

   npx octo-labels export

3. Add labels from a JSON file to a repository:

   npx octo-labels add --filePath path/to/your-labels.json

4. Delete all labels in a repository:

   npx octo-labels delete

5. Migrate labels from one repository to another:

   npx octo-labels migrate --source owner/source-repo --target owner/target-repo

These commands allow you to manage GitHub labels efficiently using the CLI.

🔖 Labels

Type Labels

Priority Labels

Status Labels

Release Labels

📄 License

This project is licensed under the MIT License. See LICENSE for details.