eas-simulator

Run and control apps on remote iOS and Android simulators hosted on EAS cloud.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill eas-simulator-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eas-simulator
Source: https://github.com/gmackie/agent-skills/tree/main/skills/eas-simulator
Command: npx skills add https://github.com/gmackie/agent-skills --skill eas-simulator-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires eas-cli, agent-device, and includes references (resource) components.

What problem does it solve? Developers on Linux, CI pipelines, or headless cloud agents cannot run an iOS simulator locally, and macOS users sometimes need a shareable or remote device. This Skill drives the experimental EAS Simulator API to boot a cloud simulator, install an app, and interact with it via an agent controller. ## Core Features & Use Cases - Remote simulator sessions: Start, monitor, and stop paid EAS cloud simulator sessions for iOS and Android using eas-cli simulator:* commands. - Agent-driven device control: Install builds, open apps, tap elements, fill fields, take screenshots, and record video through the agent-device or argent controllers. - Live edit loop: Connect a dev build to Metro over a tunnel so code changes appear on the remote simulator via Fast Refresh. - Use Case: An AI agent running in a Linux cloud sandbox needs to verify a UI fix on iOS. It starts an EAS Simulator session, installs the dev build, connects Metro, taps through the checkout flow, and captures screenshots as proof. ## Quick Start Ask the agent to run your Expo app on a cloud iOS simulator and take a screenshot of the main screen.

Frequently Asked Questions about eas-simulator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run my Expo app on a cloud iOS simulator?▼

Start a session with npx eas-cli simulator:start --platform ios, install a simulator build with agent-device install or install-from-source, then open the app and drive it via simulator:exec. Stop the session afterward to end billing.

How to run an iOS simulator on Linux or in CI?▼

EAS Simulator is the supported path since Linux cannot run local iOS simulators. Set EXPO_TOKEN for headless authentication, verify access with simulator:availability, then start a remote session and control it through agent-device.

agent-device vs argent for controlling EAS Simulator?▼

agent-device is the default controller with element refs, launch args, and Metro bridging for live reload. argent is an alternative using normalized coordinates and its own MCP server, but lacks launch-args and alert-accept handling.

Why don't my code edits show up on the remote simulator?▼

A release or static build has its JavaScript baked in at build time and can never hot-reload. Install a dev (Debug) build and connect it to Metro over a tunnel so Fast Refresh delivers live edits.

Does EAS Simulator cost money?▼

Yes, EAS Simulator is a paid Expo Application Services feature with free-tier limits, and sessions consume your plan's compute allowance. Always stop sessions when finished since they bill until stopped.

Why does simulator:start fail with not enabled for this account?▼

EAS Simulator is a limited-access feature still rolling out, so it is not enabled on every account. Check access first with simulator:availability and fall back to a local simulator or EAS Build if unavailable.