This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
Introduction to EAS Simulator
Edit page
Run and control remote iOS Simulators and Android Emulators on EAS infrastructure from the CLI, an AI agent, or a browser.
EAS Simulator is a limited-access preview. It is not included with paid or free plans and is currently available only to select partners. Join the waitlist if you are interested in trying it.
EAS Simulator runs a remote iOS Simulator or Android Emulator on EAS infrastructure. You can install an app, inspect its user interface, and interact with it. You can also collect screenshots and recordings or share an iOS browser preview without running the device locally.
EAS Simulator is built for agentic development. It gives coding agents a real device runtime for verifying agent-written code. Agents can fix issues they observe and return evidence from the running app.
EAS Simulator is especially useful when:
- A background or cloud coding agent needs device access that is not available in its sandbox
- An AI agent needs to verify a change in a running app instead of only inspecting source code
- You want a temporary, shareable iOS browser preview
- You need to offload simulator compute or test on a remote platform
Note EAS Simulator is also useful for developers on Linux or Windows who need access to an iOS Simulator, or when local resources are constrained and you want to offload the device runtime to EAS for a simpler setup.
EAS Simulator does not replace local Xcode or Android Studio workflows when you already have the required local device runtime. Use it when you need remote or shareable access.
Use EAS Simulator with a coding agent
For agentic development, start with the official EAS Simulator skill. Ask your coding agent to use the skill instead of giving it individual EAS CLI and controller commands. The skill covers the access check, build preparation, remote session, controller workflow, evidence collection, and cleanup.
Run and control a user's app on a remote iOS/Android simulator hosted on EAS cloud.
The agent can then complete the runtime loop:
- Implement or fix the code.
- Check EAS Simulator access and prepare a compatible app build.
- Start a remote device and drive the app through agent-device or Argent.
- Inspect the result and iterate if needed.
- Return screenshots, recordings, logs, or other evidence and stop the session.
Typical setup: a Cursor cloud agent
A common setup is a Cursor cloud agent or another background coding agent working in a cloud project checkout. The environment can edit and build the project, but it cannot launch a local iOS Simulator. With the EAS Simulator skill, the agent starts a remote device on EAS and controls it through agent-device or Argent. It then returns the result to the task or pull request, while your computer does not need to host the simulator.
How it works
An EAS Simulator workflow has four stages:
- Start a session with EAS CLI. EAS boots a remote device and the selected controller.
- Install your app. The remote device starts blank, so install a local build or an EAS Build artifact.
- Drive the device. Use agent-device, Argent, or the iOS browser preview.
- Stop the session. An unattended non-interactive session continues consuming usage until it stops.
EAS CLI manages the session lifecycle and connection configuration. The controller provides device actions such as opening an app, pressing a button, entering text, inspecting the accessibility tree, and capturing a screenshot.
Available surfaces
| Capability | Availability |
|---|---|
| Remote iOS Simulator | |
| Remote Android Emulator | |
| Programmatic control with agent-device | |
| Programmatic control with Argent | |
| Live browser preview for iOS | |
| Live browser preview for Android | |
| Physical device access | |
| Fast Refresh with a development build and Metro |
Use EAS Build to create installable builds, and use local device tooling for physical devices.
Next steps
Check access, start your first session, and open the dashboard and browser preview.
Install a local or EAS build, interact with the app, and capture evidence.
Review the experimental simulator commands, flags, output, and managed environment file.
Recover from unavailable accounts, stale sessions, dropped tunnels, and incorrect builds.