# ios-simulator

Run an app in iOS Simulator, inspect its accessible UI, and capture evidence. Use this skill for simulator-based testing or automation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 103 installs · ★ 4 repo stars
- Author: tristanmanchester
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tristanmanchester/agent-skills/tree/HEAD/ios-simulator/SKILL.md
- Updated: 2026-09-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tristanmanchester-ios-simulator

## What it does

The skill guides an agent through selecting a specific simulator, installing and opening an app, inspecting the current screen, and saving a screenshot. It uses `xcrun simctl` for simulator and app operations, with `idb` for accessibility-driven interaction. After an action, the agent checks whether the expected UI state appeared; a tap alone does not count as a passing test.

Local use depends on macOS, full Xcode, and an installed simulator runtime. An optional command runner needs Node.js 22+. Current `idb` companion binaries target arm64 Macs running macOS 15 with Xcode 26, so those host requirements can block local setup. Simulator results do not establish physical-device behavior or App Store readiness.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ios-simulator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ios-simulator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ios-simulator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ios-simulator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tristanmanchester/agent-skills ios-simulator
```

2. **Manually: put the files in place**
- File: `.github/skills/ios-simulator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tristanmanchester/agent-skills --path ios-simulator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ios-simulator/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tristanmanchester/agent-skills/tree/HEAD/ios-simulator/SKILL.md

## When to use it
- select a simulator by its exact UDID
- install and launch an `.app` in the simulator
- inspect UI elements through accessibility
- save a screenshot as test evidence
- diagnose a simulator launch failure

## Example prompts
- Test the app in iOS Simulator, choose the intended UDID, and save a screenshot.
- Find the sign-in field through accessibility, enter a test value, and check the resulting screen.
- Investigate why the app fails to launch in the simulator and summarize the relevant logs.

## Similar
- [limrun-ios-simulator](https://affpapa.org/en/nevibecode/skills/limrun-ios-simulator.md) — skill · 45300 installs
- [ios-simulator-skill](https://affpapa.org/en/nevibecode/skills/ios-simulator-skill.md) — skill · 2500 installs
- [ios-development](https://affpapa.org/en/nevibecode/skills/ios-development.md) — skill · 871 installs
- [argent-ios-simulator-setup](https://affpapa.org/en/nevibecode/skills/argent-ios-simulator-setup.md) — skill · 32700 installs
- [ios-simulator-browser](https://affpapa.org/en/nevibecode/skills/ios-simulator-browser.md) — skill · 53 installs
- [simulator-use](https://affpapa.org/en/nevibecode/mcp/simulator-use.md) — MCP server · ★ 6 repo stars

## Other versions with the same name
- [ios-simulator · callstack](https://affpapa.org/en/nevibecode/skills/ios-simulator.md) — 7000 installs
- [ios-simulator · dpearson2699](https://affpapa.org/en/nevibecode/skills/dpearson2699-ios-simulator.md) — 3400 installs

From the same set: [tristanmanchester/agent-skills](https://affpapa.org/en/nevibecode/by/tristanmanchester/agent-skills.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
