Repo config

relayrunner.yml turns on optimized checks for every pull request in a repo, with no workflow. Put it at .github/relayrunner.yml or the repo root.

Checks read it from the default branch, so a pull request can’t change the checks it gets.

checks:
  pr-title: true
  lint: [oxlint, typos]

checks.pr-title

true posts a PR title check on each pull request that passes when the title is a Conventional Commit. To narrow the allowed types:

checks:
  pr-title:
    types: [feat, fix, docs, chore]

By default, all the usual Conventional Commit types are allowed.

checks.lint

A list of linters to run on each pull request: any of oxlint, oxfmt, ruff, actionlint, zizmor, shellcheck and typos. To count only some files:

checks:
  lint:
    tools: [oxlint]
    paths: ["apps/**"]

Each tool gets a Lint / <tool> check run. Lint needs the RelayRunner Checks GitHub App and is in preview.

retry

Turns automatic retries on or off for the repo, whatever the workspace sets. true uses the workspace’s choices, false turns retries off here, and you can set either choice:

retry:
  runner: other # any, same or other
  max: 2 # retries per run, 1 or 2

Mistakes

The file is checked strictly. An unknown key or a bad value fails the check with the reason, instead of being ignored.