ios-simulator
- Use it when:
- You need a native, React Native, Expo or Flutter app checked on an iPhone or iPad Simulator.
- It does:
- Opens the app on iOS with agent-device straight away, follows its interactive snapshot and error hints, and shuts down any simulator it booted when done.
- Needs:
- The agent-device CLI, which you install yourself; it won't install or upgrade it.
- Unlike agent-device:
- That one is the repo's general skill for phones, TVs and Macs; this one only targets the iOS Simulator and leaves details to agent-device's own help.
- For more:
- Version-matched agent-device help on validation, debugging, React Native, React DevTools and scripting, read only when a task is specialized.
TL;DR
A short entry point to Callstack's agent-device CLI for iOS. The agent skips probing first with --help, devices or a screenshot, opens the app or bundle id with --platform ios in the foreground, then works from the snapshot agent-device returns and its corrective hints. If agent-device isn't on your PATH, it stops and asks you to install it rather than running npx with a moving version. When a task is specialized or a command's shape is unclear, it reads one of agent-device's own help topics: validate for engineering checks and build freshness, debugging for screenshots, logs, traces and video, react-native, react-devtools for components, props, state and render profiling, or scripting for replays and CI. At the end it runs agent-device close --shutdown if it booted the simulator, unless you want it kept running.
Summarizes the skill at 463fd7b.
npx skills add https://github.com/callstack/agent-device --skill ios-simulator skills.sh pageSource on GitHubAll skills from callstack/agent-device
- Total Downloads
- 6,100 on skills.sh, Nov 9, 2026
- Repo stars
- 5,303 callstack/agent-device
- First seen
- Aug 10, 2026 on skills.sh
Weekly values
| Week to | Installs |
|---|---|
| Sep 21 | 545 |
| Sep 28 | 611 |
| Oct 5 | 601 |
| Oct 12 | 608 |
| Oct 19 | 468 |
| Oct 26 | 462 |
| Nov 2 | 458 |
| Nov 9 | 475 |
| Category |
Find root causes, review code and test what you built. Drive desktop apps, phones and simulators: tap, type, read the screen and test native apps. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills. |
|---|---|
| Type |
Operates a CLI, API, app or bundled script to get something done. |
| Effect |
Its own steps create or change files, git state or local tools. |
| Needs |
A specific command-line tool or desktop app must be installed, such as gh, agent-browser, LibreOffice, Obsidian or a vendor CLI. |
| Publisher |
A verified publisher on skills.sh, or the company or maintainer behind the product the skill operates. |
| Topics | |
| Stack |
SKILL.md
From callstack/agent-device at 463fd7b. Checked daily, last changed Nov 7, 2026.
Frontmatter
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.
When you finish, if your session booted the simulator, run agent-device close --shutdown, unless the user asks to keep it running.
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 # React components, props/state/hooks, render profiling
agent-device help scripting # durable replay and CI workflows