{"id":19622169,"url":"https://github.com/commercetools/github-labels","last_synced_at":"2025-04-28T03:32:26.216Z","repository":{"id":34881706,"uuid":"184046960","full_name":"commercetools/github-labels","owner":"commercetools","description":"A cli for managing labels of a repository","archived":false,"fork":false,"pushed_at":"2023-07-11T23:38:13.000Z","size":1569,"stargazers_count":5,"open_issues_count":20,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-20T15:17:57.790Z","etag":null,"topics":["audit-internal-it","frontend"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commercetools.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-29T10:05:31.000Z","updated_at":"2022-12-10T22:56:37.000Z","dependencies_parsed_at":"2024-11-11T11:32:13.869Z","dependency_job_id":"11941ac2-70cc-43e0-9e90-5784df0223d2","html_url":"https://github.com/commercetools/github-labels","commit_stats":{"total_commits":53,"total_committers":3,"mean_commits":"17.666666666666668","dds":0.5094339622641509,"last_synced_commit":"5c9cd6b1a93152bc577bc7a42dfda5cc4a1c9a58"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fgithub-labels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fgithub-labels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fgithub-labels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fgithub-labels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commercetools","download_url":"https://codeload.github.com/commercetools/github-labels/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251246391,"owners_count":21558762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audit-internal-it","frontend"],"created_at":"2024-11-11T11:26:25.512Z","updated_at":"2025-04-28T03:32:25.292Z","avatar_url":"https://github.com/commercetools.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Labels\n\n\u003cdiv style=\"text-align: left\"\u003e\n  \u003cimg src=\"./pictures/gh-labels.png\" width=\"150px\"/\u003e\n\u003c/div\u003e\n\n## Scope\n\nA cli for managing GitHub labels.\n\n## Getting Started\n\n1. Install the Label Manager\n\nwith npm:\n\n```\nnpm install @commercetools/github-labels --save-dev\n```\n\n2. Define the authentication token\n\nGenerate a new GitHub [AUTH_TOKEN](https://github.com/settings/tokens) and write it into your **.env** file. The token should only need the `public_repo` scope (for public repositories) or `repo` (for private repositories).\n\n```\nAUTH_TOKEN=\"your-token\"\n```\n\n3. Initialize the labels config\n\nIf you don't have a labels config file yet, you can initialize one by running:\n\n```\ngithub-labels init\n```\n\n## Manage your labels\n\nGitHub labels are managed through the labels config file. The config must be in JSON format and can be defined in the following files:\n\n- `package.json`, under the name `github-labels`\n- `.github-labelsrc`\n- `.github-labelsrc.json`\n\nIf you don't have this file yet, follow the given instructions above.\nIn this file, you can see all your current label data. If you want to change something on your labels,\njust modify the file as you like. After modifying, save your changes and run the command below:\n\n```\ngithub-labels sync\n```\n\nThis will synchronize the config file with your GitHub repository.\nIf you want to see your changes, just go to your label settings on GitHub to see your current labels.\n\n### Config structure:\n\n```json\n{\n  \"id\": 1336719046,\n  \"name\": \"bug\",\n  \"color\": \"8eedc7\",\n  \"description\": \"Something isn't working\"\n}\n```\n\n### Required fields:\n\n| Data        | Required | Type                                                  |\n| :---------- | :------: | :---------------------------------------------------- |\n| id          |    no    | Id (Created by GitHub)                                |\n| name        |   yes    | String (Native emojis can be added)                   |\n| color       |   yes    | String (hexadecimal color code without the leading #) |\n| description |    no    | String                                                |\n\n### Reuse the same config across different repositories\n\nIf you have installed `github-labels` in your repository, yo can simply copy-paste the\n`.github-labelsrc.json` file into your new repository. After that, remove the ids of each\nlabel and synchronize them with GitHub:\n\n```\ngithub-labels sync\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercetools%2Fgithub-labels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommercetools%2Fgithub-labels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercetools%2Fgithub-labels/lists"}