Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

ios-simulator — Claude Code skill: test iOS apps on Simulator

Launch, inspect, and debug native, React Native, Expo, and Flutter apps on iOS Simulator from your agent. The agent can tap, type, scroll, validate code changes, and collect error logs.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add callstack/agent-device --skill ios-simulator -a claude-code
Open on GitHub

What ios-simulator does

ios-simulator is a skill for agent-device that lets an agent interact with iOS Simulator: open apps by name or bundle id, inspect the live UI, perform gestures (tap, text input, scroll), and capture screenshots for validation.

Before first use, install agent-device globally: npm install -g agent-device@latest. After that, the agent can start work immediately—it will request an interactive snapshot and provide error hints if needed. If the agent needs help with a specific command (React DevTools, video recording), it can call agent-device help react-devtools or agent-device help debugging.

Works with native iOS, React Native, Expo, and Flutter. Requires Simulator to be running and the app installed.

What it helps with

  • Launch an app on iOS Simulator and check its UI
  • Reproduce a user workflow: tap buttons, enter text, scroll through screens
  • Capture a screenshot and logs to debug an error
  • Validate a code change by running the app again
  • Debug a React Native or Flutter app with built-in tools

Example prompts for the agent

  • Start the MyApp application on iOS Simulator and show me the home screen
  • Open com.example.app, tap the Login button, and fill in test credentials
  • Take a screenshot of the crash on the simulator and help me understand what went wrong

How to install ios-simulator

1Skills CLI (Vercel)

npx skills add callstack/agent-device --skill ios-simulator -a claude-code

2Manually: put the files in place

~/.claude/skills/ios-simulator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ios-simulator/

From the same set4

The whole set →

Similar

python-debugpy openclaw Guides interactive Python debugging with pdb and debugpy remote attach. Useful for tracking down broken tests, state mutations, and headless processes. Claude Code CX Codex Cursor +1 332installs ce-riffrec-feedback-analysis EveryInc Turns recorded product feedback into structured bugs and requirements. Takes video, screenshots or notes from Riffrec and outputs a ready-to-use report for downstream agents. Claude Code CX Codex Cursor +1 2,800installs requesting-code-review Hermes Agent (adapted from obra/superpowers + MorAlekss) Pre-commit code verification pipeline that scans for security flaws, checks test regressions against a baseline, and runs an auto-fixing reviewer subagent. Claude Code CX Codex Cursor +1 467installs qa garrytan Automate bug hunting in browser, API, CLI, jobs, workers, and webhooks. Searches code, runs commands, checks logs, and asks clarifying questions. Claude Code CX Codex Cursor +1 457installs embedded-systems https://github.com/Jeffallan Configure your coding assistant for microcontroller firmware, bare-metal C, and FreeRTOS applications. It helps structure drivers, ISRs, and low-power routines under tight memory limits. Claude Code CX Codex Cursor +1 6,700installs code-reviewer https://github.com/Jeffallan Analyzes code diffs and files to spot bugs, security vulnerabilities (SQL injection, XSS), code smells, N+1 queries, and returns a prioritized review report. Use for pull request reviews and code audits. Claude Code CX Codex Cursor +1 6,500installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. Claude Code CX Codex Cursor +1 673,100installs

Questions about ios-simulator

How do I install ios-simulator in Claude Code?

Run npx skills add callstack/agent-device --skill ios-simulator -a claude-code. The skill will be available at ~/.claude/skills/ios-simulator/SKILL.md.

What do I need before using ios-simulator?

Install agent-device globally: npm install -g agent-device@latest. iOS Simulator must be running and the app installed. The agent will request a screenshot on first use.

Does ios-simulator work with React Native and Flutter?

Yes, it supports native iOS, React Native, Expo, and Flutter. For React component debugging, use agent-device help react-devtools; for logs and video, use agent-device help debugging.

Source text

SKILL.md · MIT
---
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:

```bash
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:

```bash
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:

```bash
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
```

© callstack · MIT · callstack/agent-device

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor