loat-dev/Repository Categories

This action creates a list of categories from the repositories in a GitHub organization.

Trust Signals

workflow.ymlSHA-pinned

uses: loat-dev/repository-categories@1eb4043a69452145cc3f2e25186d756c3d3941f9 # no releases — HEAD as of 2026-07-11

tags can be moved; commit SHAs can't. why a SHA?

name	description	required	default
token	The GitHub token to use.	yes	—
config-file	The configuration file to use.	no	—
organization-name	If already specified in the configuration file, this will be omitted. The name of the organization in which to search the repositories for the categories.	no	${{ github.event.repository.owner.name }}
only-public-repositories	If already specified in the configuration file, this will be omitted. Query only public repositories. Private repositories will be ignored.	no	true
template-files	If already specified in the configuration file, this will be omitted. Template files to use for the categories.	no	readme: './.github/categories/templates/readme.md' category: './.github/categories/templates/category.md' repository: './.github/categories/templates/repository.md'
label-search-pattern	If already specified in the configuration file, this will be omitted. The category regex search pattern to use when searching for category labels in the repositories. Specify the categories as comma separated values in the label description.	no	/category/g
repository-blacklist	If already specified in the configuration file, this will be omitted. List of repository names to blacklist.	no	—
categories	If already specified in the configuration file, this will be omitted. The category mapping. Use an empty key for the default category. Example: "": "No Category" "category_1": "Category 1"	no	"": "No Category"

name	description
generated-readme-text	The generated README file with the categories.
categories-changed	If a category was added/changed/removed.