eas-simulator
Run and control a user's app on a remote iOS/Android simulator hosted on EAS cloud. Read before running any `eas simulator:*` commands - it has the current syntax for this experimental API
Install / Use
npx skills add expo/skills --skill eas-simulatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of eas-simulator
eas-simulator scores 95/100 on our quality scale, 408th of 4,698 Development & Engineering skills we index (top 9%).
Its SKILL.md is 25 KB long, well organised into 29 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
With 2,602 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so eas-simulator is actively maintained.
- Our last check on 2026-11-16 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk β read a skill before letting an agent act on it.
eas-simulator compared with similar skills
All 4 of these similar skills score higher than eas-simulator; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| eas-simulator (this skill)by expo | 95 | 2.6k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install eas-simulator?
- Run
npx skills add expo/skills --skill eas-simulator. The install tabs above show the steps for each supported agent. - Which AI agents does eas-simulator work with?
- It is written for Cursor, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is eas-simulator safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is eas-simulator still maintained?
- The repository was last updated about 2 months ago, so eas-simulator is actively maintained.
Skill content
View source on GitHubname: eas-simulator
description: "EAS service (paid). Run and control a user's app on a remote iOS/Android simulator hosted on EAS cloud. Read before running any eas simulator:* commands - it has the current syntax for this experimental API. Use whenever the user needs a simulator they can't run locally - 'run my app on a cloud simulator', 'use eas simulator to run/install/screenshot my app', 'I'm on Linux/Cursor and need an iOS device', 'no sim on this box / headless CI', 'let an agent click through my app and screenshot it', 'test my dev build on a remote sim with live reload', 'stream a sim to my browser' - even when they don't say 'EAS Simulator' or 'cloud'. On a host WITHOUT a local simulator (Linux, CI, cloud sandbox) it's the default; on macOS, do NOT auto-trigger for a plain 'run on the simulator' - use it only for a cloud/remote/shareable sim, an iOS version they lack, or an agent-driven session. NOT for local sims (expo run:ios, Xcode, Android Studio), EAS Build/Update, web preview, or physical devices."
version: 1.0.0
license: MIT
allowed-tools: "Bash(npx eas-cli@), Bash(npx agent-device@), Bash(npx expo *), Bash(eas ), Bash(expo ), Bash(xcodebuild), Bash(pod), Bash(argent ), Bash(ffmpeg)"
EAS Simulator
EAS service - costs apply. EAS Simulator is a hosted EAS service. Session usage is subject to your account's pricing and limits. See https://expo.dev/pricing for current terms.
EAS Simulator runs a remote iOS simulator or Android emulator on EAS infrastructure that you drive from your machine β from the CLI, from an AI agent (via agent-device), and from a browser preview. It's the unlock for environments that can't run a simulator locally (Linux boxes, cloud/background agents like Cursor Cloud), and for letting an agent verify a change on a real device instead of only reasoning about code.
The simulator:* commands are experimental and hidden, and need a recent eas-cli (β₯ 20.3.0 as of writing) β which is why this skill runs everything via npx --yes eas-cli@latest. Flags and verbs may change; the relevant subcommand's --help output is authoritative.
When to use
The frontmatter description carries the trigger phrases. In short: use this to get a user's app onto a cloud simulator and interact with it β especially from a Mac-less or cloud/sandbox agent. Not for local sims (expo run:ios, Xcode, Android Studio), store builds/signing (that's EAS Build), or physical devices. For the macOS case, see Cloud vs local next.
Cloud vs local: decide this first
- Explicit cloud/remote/shareable request: use EAS Simulator after checking access, on any host.
- Generic simulator request: use a suitable local simulator when available. If the host cannot run the requested simulator (for example, iOS on Linux or a cloud sandbox), use EAS Simulator after checking access. A non-macOS host may still support a local Android emulator.
- Honor an explicit local choice; hand off to
expo run:ios/ Xcode / Android Studio as appropriate. Clarify only when the requested environment remains ambiguous and affects the task.
When the user requests EAS Simulator or a cloud simulator, proceed within that request and any stated budget. Explain applicable usage once and carry existing authorization through the session. Ask before exceeding a stated budget or expanding beyond the requested work.
Prerequisites
- Run every
eascommand vianpx --yes eas-cli@latest β¦β guarantees a CLI new enough to havesimulator:*(a globaleasis often too old), and--yesskips npx's prompt. (Bareeasis fine ifeas --versionis current.) - Authenticated. Interactive machine β
npx --yes eas-cli@latest login. Cloud sandbox / CI / headless agent has no browser login β setEXPO_TOKEN(expo.dev β Account β Access Tokens) in the env instead. Verify either way withnpx --yes eas-cli@latest whoami. - Run from an Expo project directory. A fresh app needs one-time setup:
npx --yes eas-cli@latest initto create/link the project (when there's noprojectId), and setios.bundleIdentifierin app config if it's missing β a freshcreate-expo-appoften has none, andprebuild/eas buildneed it (they prompt or fail without it; e.g.dev.<owner>.<slug>). Read current config withnpx expo config --json(it may live inapp.config.js). The first Mode-C run is slow (native build); later runs reuse it. - A controller to drive the device. This skill uses agent-device (open source, MIT), run on demand via
npx agent-device@latestβ nothing globally installed. Appium and argent are alternative automation interfaces;web-preview-onlyhas no automation interface. See references/controllers.md. .env.eas-simulatoris written/managed by eas-cli (not this skill): it holds the session id (EAS_SIMULATOR_SESSION_ID) + the daemon URL/token, soget/stop/execdefault to that session (usually omit--id; pass--id <id>to target another). It carries a token β keep it gitignored (eas-cli marks it "do not commit" but may not add the ignore rule, and a fresh app's.gitignorewon't cover it β add.env.eas-simulatorif missing).- The command blocks assume a POSIX shell (bash/zsh) β
printf,lsof,$(seq β¦)loops won't run in cmd/PowerShell. On Windows, run them in WSL or Git Bash, or translate as you go (theeas-cli/agent-deviceinvocations themselves are cross-platform).
Session lifetime
--max-duration-minutes Nis the hard automatic-stop deadline. Customize it when supported by the account; otherwise use the service's default session limit.--max-idle-time-minutes Nstops a session after that many inactive minutes. Omitted means no idle timeout: the session runs until its maximum duration or an explicit stop.- Only activity reported through
agent-deviceandargentresets the idle timer. Appium commands and browser-preview activity do not reset it. For Appium or a user-driven browser preview, rely on the maximum durationβnot idle timeβto bound the session; customize it with--max-duration-minuteswhen supported by the account.
Check availability first
EAS Simulator is a limited-access EAS feature that is still rolling out, so it isn't enabled on every account. Check access before starting a session; this read-only command does not create a session.
npx --yes eas-cli@latest simulator:availability --json
# β {"available": true, ...} enabled β continue to the core loop
# β {"available": false, ...} not enabled β do NOT start a session
If it's not available, don't call simulator:start (it will fail). Instead, hand off gracefully so you keep making progress without this skill:
- Tell the user EAS Simulator isn't available on their account yet β it's coming soon.
- Fall back to their normal local path for the actual goal β
expo run:ios/ Xcode / Android Studio for a local sim/emulator, an EAS Build, or whatever else fits. Don't dead-end on the cloud sim; the request was almost never "use EAS Simulator specifically."
(If simulator:availability isn't recognized, the CLI is too old β upgrade, or treat a not enabled for this account error from simulator:start the same way: stop and fall back.)
The core loop (always the same)
A session is: start β (install your app) β drive β stop. eas-cli owns the session; the device verbs (open/tap/screenshot) come from the controller, which npx --yes eas-cli@latest simulator:exec runs for you with the session's connection env loaded.
# 1. Start a session (boots the remote sim + agent-device daemon; writes .env.eas-simulator).
# If the dotenv names a session, inspect it with simulator:get --json first. Reuse it when it
# belongs to this run; stop it only when it is in scope and no longer needed. An IN_PROGRESS
# session may be intentionally concurrent, so preserve its id/config before resetting the dotenv.
# Continue below only after choosing how to handle that existing session.
printf '# managed by eas-cli\n' > .env.eas-simulator # clear only after resolving any live session
npx --yes eas-cli@latest simulator:start --platform ios --type agent-device --non-interactive \
--name "Checkout flow screenshots" # always name it β see 'Always name the session'
# Then confirm it's live: simulator:get --json β status IN_PROGRESS (bounded poll in run-your-app.md).
# 2. Drive it through `exec` (loads the session env, then runs the command you give it).
# agent-device runs on demand via npx β nothing installed globally.
npx --yes eas-cli@latest simulator:exec npx agent-device@latest open <app-or-url> --platform ios
npx --yes eas-cli@latest simulator:exec npx agent-device@latest snapshot -i # interactive UI tree β @e1, @e2 refs
npx --yes eas-cli@latest simulator:exec npx agent-device@latest press @e2 # tap a ref (NOTE: 'press', not 'tap')
npx --yes eas-cli@latest simulator:exec npx agent-device@latest screenshot ./shot.png
# 3. Stop the session and reset the dotenv. Omit --id to target the dotenv session.
npx --yes eas-cli@latest simulator:stop
printf '# managed by eas-cli\n' > .env.eas-simulator
To watch it live, hand the user the webPreviewUrl that start prints. All current session types include a browser preview; agent-device, appium, and argent also provide automation, while web-preview-only provides no automation interface. This URL is for the user's browser β you cannot open it for them, and it must never touch the sim:
- "Open it here" (Cursor/VS Code) β print the URL on its own line and tell the user to open Simple Browser (
Cmd/Ctrl+Shift+Pβ "Simple Browser: Show") and paste it. Then stop: do not shell out to a system browser or a Cursor/VS Code URL handler, and do not ask "did a tab appear?" β you can't confirm it, the handoff is done. - Never
openthewebPreviewUrlon the sim. It's a browser preview, not a deep link and not anagent-device openargument; routing it to the device renders a browser-in-a-browser (a real past failure). - Headless agent (no display) β just return the URL as the deliverable.
- Keeping it alive for the user to drive β use
--max-duration-minutes Nwhen supported, otherwise use the service's default limit. Browser-preview activity does not reset--max-idle-time-minutes, so idle timeout is not a reliable lifetime bound for this case. Tell the user when the session expires, using the CLI's reported duration or expiry. Keep it running for the requested preview; stop sessions created for one-shot tasks when the task finishes.
start also prints a job-run URL.
Always name the session
Pass --name "<description>" on every simulator:start. The name appears in simulator:list, simulator:get, and on the Simulator sessions page on expo.dev, where it replaces the generic title on each row. Unnamed, every row reads "Simulator session" over a random id β a wall of identical entries nobody can navigate. Write the name for a human scanning that list days later, not for yourself during this run.
Write what the session is for, in a few plain words:
--name "Checkout flow screenshots" # what you did
--name "Dev build β dark mode fix" # what you were testing
--name "Login repro for issue 412" # why it exists
Rules:
- Derive it from the user's request, not from the mode or the tooling.
Mode C session,agent-device ios, andtestsay nothing. - Length: aim for 3β6 words, ~40 characters, and treat 50 as the practical limit. It renders as a single-line title in a narrow table column, so a long name clips. The API accepts up to 255 characters and rejects an empty/whitespace-only name, but 255 is a ceiling you never approach, not a target. One noun phrase, no sentences.
- Be specific within that budget. Include a ticket or PR number when there is one.
- **
Truncated for display β read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
