eas-simulator

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

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/bmiit145/leadBee --skill eas-simulator-bmiit145
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eas-simulator
Source: https://github.com/bmiit145/leadBee/tree/main/mobile/.agents/skills/eas-simulator
Command: npx skills add https://github.com/bmiit145/leadBee --skill eas-simulator-bmiit145

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 remote device. This Skill drives the experimental EAS Simulator service to boot a remote simulator, install an app, and control it from the CLI or an AI agent. ## Core Features & Use Cases - Remote simulator sessions: Start, monitor, and stop iOS/Android simulator sessions on EAS cloud via eas simulator:* commands, with a browser preview URL for iOS. - Agent-driven device control: Install apps, tap elements, fill fields, take screenshots, and record video through the agent-device or argent controllers. - Live edit loop: Connect a dev-client build to Metro over a tunnel so code changes appear on the remote simulator via Fast Refresh. - Use Case: An agent on a Linux CI box needs to verify a UI fix on iOS — it starts an EAS Simulator session, installs the dev build, connects Metro, taps through the flow, and captures screenshots as proof. ## Quick Start Ask the assistant to run your Expo app on a remote cloud simulator and take a screenshot of the result.

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 --yes eas-cli@latest simulator:start --platform ios --type agent-device`, then install a build and open it via `simulator:exec npx agent-device@latest open <bundleId>`. The session prints a webPreviewUrl for live browser viewing on iOS.

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 with `eas whoami`, then start a remote session and drive it with agent-device commands.

Does EAS Simulator support live reload with Metro?▼

Yes, via a dev (Debug) build connected to Metro over a tunnel using `EXPO_UNSTABLE_TUNNEL_V2=1 expo start --tunnel`. Release builds have JS baked in and can never hot-reload, so a dev-client build is required for live edits.

Why does my eas simulator:start command fail?▼

Common causes are an outdated eas-cli (simulator commands need version 20.3.0 or newer), missing authentication, or the account not being allowlisted for this limited-access feature. Run `simulator:availability --json` to check access before starting a session.

Is EAS Simulator free to use?▼

No, it is a paid EAS service with free-tier limits; sessions consume your plan's compute allowance. Always stop sessions with `simulator:stop` when done, since a forgotten session keeps billing until stopped.

When should I use a local simulator instead of EAS Simulator?▼

On macOS with Xcode installed, local simulators via `expo run:ios` are faster and free, so prefer them for ordinary runs. Use EAS Simulator only for cloud or shareable sessions, iOS versions you lack locally, or agent-driven testing.