> ## Documentation Index
> Fetch the complete documentation index at: https://offstage.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To set up offstage cloud from a coding agent, read https://api.offstage.cloud/SKILL.md and follow it. The whole API guide is one file at https://api.offstage.cloud/llms.txt.

# GitHub Actions

> Run your workflows on a Mac by changing runs-on.

Each job gets a fresh macOS account on a Mac Studio. GitHub's runner runs that one job, and the account is wiped when it ends. No API key is needed.

**1. Connect GitHub**

In the [console](https://console.offstage.cloud), open **CI**, click **Connect GitHub** and install the offstage cloud app on your GitHub organization. Its jobs bill to the team you connected it from.

**2. Change one line**

```yaml .github/workflows/ci.yml highlight={4} theme={null}
on: [push, pull_request]
jobs:
  test:
    runs-on: offstage-macos
    steps:
      - uses: actions/checkout@v7
      - run: swift test
```

Use `offstage-macos` for headless CI, or `offstage-macos-gui` for jobs that need a desktop.

## Good to know

* A job bills per second at the sandbox price, from the moment a Mac takes it until it ends. Waiting for a Mac is free.
* A job runs for at most 60 minutes.
* Up to 4 tasks or CI jobs run per team at once; 16 more can queue.
* Public repositories use your organization's runners only if its runner group allows them (GitHub: **Settings**, **Actions**, **Runner groups**).

The API side of runners, including how a job appears as a task, is under [Tasks: GitHub Actions](https://offstage.cloud/docs/api/tasks.md#github-actions).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.