Copy logo as SVG
Copy wordmark as SVG
Download brand assets
Brand guidelines

Tuist Runners for GitHub Actions: macOS and Linux

Tuist Runners run GitHub Actions jobs on Tuist's fleet; your workflows and triggers stay on GitHub. Runners are invite-only while capacity scales; request an invitation.

Switch a job with one line

Connect your GitHub organization to Tuist, then point runs-on at a Tuist profile:

No runner agent to install. Accounts start with tuist-macos and tuist-linux profiles; see the GitHub Actions guide for the full setup.

diff
jobs:
build:
- runs-on: macos-latest
+ runs-on: tuist-macos
steps:
- uses: actions/checkout@v4
- run: tuist test

How it differs from GitHub-hosted runners

  • A build cache shared beyond CI. Runners share the Tuist cache with developer machines and coding agents.
  • Directories that survive between jobs. Cache volumes keep DerivedData and other caches between jobs.
  • Xcode selected by the profile. Each profile pins one Xcode version, so workflows drop xcode-select steps.
FAQs

Frequently asked questions

Do we have to leave GitHub Actions?

No. Workflows, triggers, secrets, and checks stay in GitHub Actions. Only the machine that runs the job changes.

Which runner labels can we use?

The tuist- prefix plus a profile name, such as tuist-macos, tuist-linux, or tuist-xcode-26-4 for a profile you create. Matching is case-insensitive.

Can we keep some jobs on GitHub-hosted runners?

Yes. Each job chooses its runner through runs-on, so you can move one job at a time.

Do Linux runners support Android emulators?

Yes. Linux runners expose /dev/kvm, so x86_64 Android emulators and Gradle Managed Devices run without a special profile. See Android emulators.

Why not stay on GitHub-hosted runners?

GitHub-hosted runners give each job a fresh VM, and actions/cache keeps per-repository archives (10 GB by default, evicted after 7 days unused). Tuist Runners add a build cache shared with developer machines and coding agents, cache volumes that keep directories between jobs, and Xcode selected by the profile.

How is it priced?

Runners are billed per minute by machine shape. See the pricing page for current rates, and compare them against the total cost of the job, not only the per-minute price.

What are you waiting for?

Move your next CI job to Tuist

Request access Talk to us