docs

Runner labels and runs-on

A job's runs-on lists labels, and GitHub gives the job to a runner that has every one of them. Codemany's runners register with the labels shown in Settings, so paste the workflow example into a job and it runs on your Mac. Add xcode-… or docker only when a job needs them: each label you add narrows which runners can take it.

Labels

• self-hosted Every runner GitHub doesn't host carries self-hosted.
• macOS The runner's operating system, added by GitHub's runner on every Mac.
• ARM64 The CPU architecture, added by GitHub's runner.
• codemany Codemany adds it to every runner it starts.
• xcode-<version> Follows the Xcode chosen with xcode-select, for example xcode-26.0.
• docker Present only while a Docker engine (Docker Desktop or Colima) answers on your Mac.

Example

A complete workflow file, for example .github/workflows/ci.yml:

name: CI
on:
  push:
    branches: [main]
  pull_request:
jobs:
  test:
    runs-on: [self-hosted, codemany]
    steps:
      - uses: actions/checkout@v4
      - run: make test