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

Tuist Runners for Buildkite: macOS and Linux agents

Tuist watches self-hosted queues in your Buildkite cluster and runs their jobs on its fleet, next to the same build cache your developers and coding agents use. Runners are invite-only while capacity scales; request an invitation.

Target a queue named after a profile

Create a cluster agent token in Buildkite, connect it in Tuist, create self-hosted queues keyed after Tuist profiles, and target one from a step:

No Buildkite agent to install and no API token needed: logs ship with a job-scoped credential. See the Buildkite guide.

diff
steps:
- label: "Test"
command: tuist test
agents:
- queue: macos
+ queue: tuist-macos

How it differs from your current agents

  • No fleet to operate. Tuist provides the machines; pick a profile by CPU, memory, and Xcode or Ubuntu version.
  • 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 build caches between jobs.
FAQs

Frequently asked questions

Do we have to leave Buildkite?

No. Pipelines, scheduling, and the Buildkite UI stay as they are. Only the machines for Tuist queues change.

Can we mix Tuist queues with our own agents?

Yes. Tuist only serves queues keyed after its profiles; other queues keep using your agents.

Which machines are available?

macOS on Apple silicon and Linux, in the shapes your account's profiles allow. The dashboard and tuist runner profile catalog show the current catalog.

Why not run our own Mac agents?

Buildkite pipelines run on Buildkite hosted agents or agents you operate. Running your own Mac agents means maintaining machines, images, and Xcode upgrades. Tuist Runners keep Buildkite as the orchestrator and take over the machines.

Can we pause a queue?

Yes. Pausing dispatch on a queue stops Tuist taking new jobs from it; running jobs are unaffected.

How is it priced?

Runners are billed per minute by machine shape. See the pricing page for current rates.

What are you waiting for?

Move your next CI job to Tuist

Request access Talk to us