> ## 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.

# Set up from your agent

> One prompt, and your coding agent sets itself up to run builds and tests on a real Mac.

Coding agents set themselves up from one file, [SKILL.md](https://api.offstage.cloud/SKILL.md). It covers the key handoff, the install, paths and cleanup, then has the agent run one command on a real Mac and report what it verified.

Paste this into Claude Code, Codex, Cursor or any agent that can run commands:

```text Prompt theme={null}
Read https://api.offstage.cloud/SKILL.md and follow it to set up offstage cloud, so you can run builds, tests and commands on a real Mac.
```

> [!TIP]
>
> If `OFFSTAGE_API_KEY` isn't set, the agent asks you to create a key in the [console](https://console.offstage.cloud/sign-up) and export it, or put it in a gitignored `.env`. It keeps the key out of source, commits, logs and the commands it sends to the Mac.

## Install it as a skill

To keep the skill in your agent's context instead of fetching it each time, install it with the [skills CLI](https://www.npmjs.com/package/skills):

```bash theme={null}
npx skills add https://offstage.cloud
```

## Give your agent a Mac desktop

Connect your own computer-use agent to a GUI sandbox. The guide includes the desktop helper, instructions for passing screenshots to your model, and a tested Codex example. [Computer use on macOS](https://offstage.cloud/docs/computer-use.md)

## Save and restore a sandbox

Give your agent a ready sandbox to capture, or a saved snapshot ID to restore. The [snapshots guide](https://offstage.cloud/docs/snapshots.md#use-agent-tools) shows how to capture from the CLI and check for a verified upload.

## What the agent reads

| File | What it holds |
| - | - |
| [SKILL.md](https://api.offstage.cloud/SKILL.md) | Setup, a verified first run, troubleshooting and the habits that keep a bill small |
| [llms.txt](https://api.offstage.cloud/llms.txt) | The whole API guide, the same text as the [API reference](https://offstage.cloud/docs/api.md) |
| [openapi.json](https://api.offstage.cloud/openapi.json) | Every operation and schema |

These docs are written for agents too. Add `.md` to any page's address for its Markdown, or read [llms.txt](https://offstage.cloud/docs/llms.txt) for an index of every page.


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