mcpField
I
ios-simulator

ios-simulator

github.com/callstackTesting & quality5.2k5.3k installsUpdated today
Repository

About ios-simulator

ios-simulator is a skill that guides agents in driving iOS simulators with the separately installed agent-device CLI. It gives task-specific operating rules and points to help topics for specialized workflows.

Key features

  1. 01Explicit iOS targeting
  2. 02Interactive snapshot-driven operation
  3. 03Setup ownership guidance
  4. 04Help topics for debugging and scripting

Use cases

  1. 01Open and operate an iOS app
  2. 02Resolve simulator task errors
  3. 03Find guidance for React Native or replay workflows

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/callstack/agent-device --skill ios-simulator

After installing, type/ios-simulatorin Claude Code to confirm it loaded.

Details

From the project README

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  # React components, props/state/hooks, render profiling
agent-device help scripting       # durable replay and CI workflows

Comments

Markdown supported