Target your workflows

Labels

Each host serves the labels in its agent.yaml. A job goes to a host only when the host has every label in the job's runs-on.

jobs:
  build:
    runs-on: [self-hosted, macOS, ARM64]

ushr init

Run it in a repository checkout:

ushr init --dry-run   # report what would change
ushr init             # rewrite .github/workflows in the current directory
ushr init --dry-run path/to/repo

Put flags before the directory. The command reads every .yml and .yaml file in .github/workflows. It changes only job-level runs-on lines and keeps all other lines as they are.

What ushr init leaves alone

• Targets that already include self-hosted.
• Custom labels and multi-label targets.
• Intel macOS labels (macos-13 and the -large tier). ushr Macs are ARM64. It prints a warning.
• Windows labels. ushr has no Windows driver.
• Expressions such as matrix values, the group form, YAML anchors and multi-line values. It prints a warning so you can edit them by hand.

After a rewrite, make sure your ushr GitHub App is installed on the repository.

next GitHub App and webhook →