Forgejo Labeler

Forgejo's actions/labeler. Apply labels to a pull request based on which files it changes, matched against a config of label -> glob patterns, via the Forgejo API. No github.com.

Part of the Fjord Actions bundle.

Usage

.forgejo/labeler.yml:

frontend:
  - 'web/**'
  - '**/*.css'
docs:
  - 'docs/**'
  - '**/*.md'
ci:
  - '.forgejo/**'

Workflow:

on:
  pull_request:

permissions:
  pull-requests: write

jobs:
  label:
    runs-on: [self-hosted, Linux]
    steps:
      - uses: actions/checkout@v6
      - uses: https://rasterhub.com/rasterstate/forgejo-labeler-action@v1
        with:
          sync-labels: true
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}   # a Forgejo token on Forgejo

Config

A flat map of label -> glob patterns. A label applies when any of its patterns matches any changed file in the PR. YAML (indented list or inline array) and JSON both work:

docs: ['docs/**', '*.md']     # inline array
ci: '.forgejo/**'             # single value

Globs support * (within a path segment), ?, ** (across segments), and literal paths. Nested matcher objects (any-glob-to-any-file, all-globs-to-...) are not supported, use flat glob lists.

Inputs

Input	Default	Description
configuration-path	.forgejo/labeler.yml	Path to the label -> globs config.
sync-labels	false	Remove configured labels that no longer match.
pr-number	from context	PR to label (defaults to the event's pull_request).
token	GITHUB_TOKEN env	Forgejo token with PR write.
repository	GITHUB_REPOSITORY	Target repo.
api_url	derived	Forgejo API base.

Outputs

Output	Description
new-labels	JSON array of labels added this run.
all-labels	JSON array of the PR's labels after this run.

Labels referenced in the config that don't exist yet are created automatically.

See MIGRATION.md for differences from actions/labeler.

License

MIT, see LICENSE.