ios-simulator
callstack/agent-device
Launch, inspect, and automate iOS Simulator testing for native, React Native, Expo, and Flutter apps.
What is ios-simulator?
iOS Simulator is a skill for driving and validating apps on iPhone or iPad simulators using the agent-device CLI. Use it when you need to launch an app, inspect its UI, simulate user interactions (tap, type, scroll), validate code changes, or collect failure evidence.
- Launch apps or bundles on iOS Simulator with explicit platform targeting
- Inspect live UI and take snapshots of the simulator state
- Simulate user interactions: tap, type, scroll, and other gestures
- Validate code changes and test workflows on simulated devices
- Collect screenshots, logs, traces, and failure evidence for debugging
- Support native, React Native, Expo, and Flutter applications
How to install ios-simulator
npx skills add https://github.com/callstack/agent-device --skill ios-simulator- agent-device CLI installed globally: npm install -g agent-device@latest
- Xcode and iOS Simulator tools available on the system
- A built app or valid bundle ID to launch
How to use ios-simulator
- 1.Install agent-device globally if not already present: npm install -g agent-device@latest
- 2.Launch the app on iOS Simulator: agent-device open <app-or-bundle-id> --platform ios --foreground
- 3.Follow the interactive snapshot output and any corrective error hints
- 4.Use tap, type, scroll, and other commands to interact with the app UI
- 5.Take snapshots or screenshots to inspect the current state: agent-device help debugging
- 6.For specialized tasks, consult help topics: agent-device help validate, agent-device help react-native, or agent-device help scripting
Use cases
- Verify a UI change renders correctly on iPhone or iPad before merging
- Reproduce a reported bug by replaying user interactions on the simulator
- Validate that a React Native app launches and responds to taps after a code update
- Collect screenshots and logs when a test fails to diagnose the root cause
- Test Expo or Flutter app behavior across different simulator configurations
- Mobile app developers (native iOS, React Native, Expo, Flutter)
- QA engineers validating app functionality on simulators
- CI/CD pipelines automating app testing and validation
- Agents performing automated testing and debugging tasks
ios-simulator FAQ
Yes. The skill requires agent-device to be installed separately as a global npm package before use. The agent will not install it autonomously.
Native iOS, React Native, Expo, and Flutter applications.
Yes. The skill supports durable replay and CI workflows; see agent-device help scripting for guidance.
Stop and ask the user to install it (npm install -g agent-device@latest) or ensure their existing installation is on PATH.
No. Start the task immediately without probing commands. Only use help topics when the task is specialized or a command shape is unclear.
Full instructions (SKILL.md)
Source of truth, from callstack/agent-device.
name: ios-simulator description: Verify and debug native, React Native, Expo, or Flutter apps on an iOS Simulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an iPhone or iPad Simulator.
iOS Simulator
Require the agent-device CLI to be installed separately before driving a simulator:
npm install -g agent-device@latest
Treat installation and upgrades as user-owned setup steps. Do not run that command autonomously or substitute a mutable npx -y agent-device@latest invocation.
For a normal app-driving task, start immediately. Do not probe first with --help, --version, devices, appstate, snapshot, or screenshot. Target iOS explicitly when opening an app or bundle id:
agent-device open <app-or-bundle-id> --platform ios --foreground
Follow the initial interactive snapshot and corrective error hints. If the shell reports that agent-device is unavailable, stop and ask the user to install it or expose their existing installation on PATH.
Only when the task is specialized or a command shape is unclear, read the relevant version-matched help topic:
agent-device help validate # engineering validation and build freshness
agent-device help debugging # screenshots, logs, traces, video, and failures
agent-device help react-native # React Native and Expo runtime guidance
agent-device help react-devtools # component tree, props/state/hooks, and renders
agent-device help scripting # durable replay and CI workflows
Related skills
More from callstack/agent-device and the wider catalog.
react-devtools
Agent skill from callstack/agent-device.
agent-device
Automate iOS, Android, macOS, tvOS, and Amazon Vega TV apps via CLI commands.
android-emulator
Launch, inspect, and automate testing on Android Emulator with agent-device.
dogfood
Systematically explore and test mobile apps on iOS/Android to find bugs and UX issues.
react-native-testing
Write React Native component tests with Testing Library v13/v14 queries, userEvent, and Jest matchers.
agent-device
Automate iOS, tvOS, macOS, and Android device interactions—tap, type, scroll, screenshot, and extract UI data.