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

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.

eas-simulator

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:

  1. Implement or fix the code.
  2. Check EAS Simulator access and prepare a compatible app build.
  3. Start a remote device and drive the app through agent-device or Argent.
  4. Inspect the result and iterate if needed.
  5. 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:

  1. Start a session with EAS CLI. EAS boots a remote device and the selected controller.
  2. Install your app. The remote device starts blank, so install a local build or an EAS Build artifact.
  3. Drive the device. Use agent-device, Argent, or the iOS browser preview.
  4. 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

CapabilityAvailability
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

Get started

Check access, start your first session, and open the dashboard and browser preview.

Run and control your app

Install a local or EAS build, interact with the app, and capture evidence.

CLI reference

Review the experimental simulator commands, flags, output, and managed environment file.

Troubleshooting

Recover from unavailable accounts, stale sessions, dropped tunnels, and incorrect builds.