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

argent-ios-simulator-setup — Claude Code skill: boot and connect iOS

A skill for connecting to an iOS simulator via argent MCP tools. Use it to find a booted simulator, get its UDID, and prepare for any interaction task.

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

What argent-ios-simulator-setup does

The skill handles two core operations: finding an already-booted simulator using list-devices (filters out physical devices and picks the first available iOS simulator) and booting a specific device with boot-device if none are running.

All interaction tools (gesture-tap, gesture-swipe, gesture-custom) automatically start the MCP server if it isn't running yet. The simulator UDID has the format A1B2C3D4-E5F6-7890-ABCD-EF1234567890 — pass it to any command that needs it.

If you delegate simulator tasks to sub-agents, verify they have MCP-permissions access.

What it helps with

  • find a booted iOS simulator
  • boot and connect to a new simulator
  • retrieve a simulator UDID for interactions
  • start the MCP server before automation
  • distinguish a simulator from a physical device

Example prompts for the agent

  • Connect to an iOS simulator and find the first available one
  • Boot the simulator with UDID A1B2C3D4-E5F6-7890-ABCD-EF1234567890
  • Set up a simulator for argent before running UI tests

How to install argent-ios-simulator-setup

1Skills CLI (Vercel)

npx skills add software-mansion/argent --skill argent-ios-simulator-setup -a claude-code

2Manually: put the files in place

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

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

From the same set15

The whole set →
argent-android-emulator-setup software-mansion This skill connects an Android emulator through argent MCP tools. Use it to find a device or boot an AVD before working with an Android UI. Claude Code CX Codex Cursor +1 26,500installs argent-react-native-optimization software-mansion Profiles React Native apps to pinpoint runtime bottlenecks and fixes mechanical code issues. It steps in when user screens stutter, startup lags, or re-renders spike. Claude Code CX Codex Cursor +1 26,400installs argent-react-native-profiler software-mansion Profiles a React Native Hermes app to measure re-renders and CPU use. Use it to compare a fix, find slow components, or inspect hotspots. Claude Code CX Codex Cursor +1 26,300installs argent-react-native-app-workflow software-mansion Provides step-by-step procedures for building, running, and debugging React Native apps on iOS simulators or Android emulators. Helps resolve Metro issues and build crashes. Claude Code CX Codex Cursor +1 26,300installs argent-native-profiler software-mansion Profiles native performance on iOS and Android to find CPU hotspots and UI hangs. It also analyzes memory leaks on iOS. Claude Code CX Codex Cursor +1 26,200installs argent-metro-debugger software-mansion A skill that connects a debugger to a JS runtime via CDP. Inspect React components, read console logs, and evaluate code live. Works with React Native (iOS, Android, Vega) and Chromium apps (Electron, browsers). Claude Code CX Codex Cursor +1 26,200installs argent-test-ui-flow software-mansion A skill for autonomous iOS and Android UI testing in Claude Code. Runs interact-screenshot-verify loops through argent MCP tools to check flows and screens. Claude Code CX Codex Cursor +1 26,200installs argent-screenshot-diff software-mansion Compares before and after screenshots to catch layout shifts, spacing, color and text rendering changes. Claude Code CX Codex Cursor +1 24,900installs

Similar

Questions about argent-ios-simulator-setup

How do I install argent-ios-simulator-setup in Claude Code?

Run npx skills add software-mansion/argent --skill argent-ios-simulator-setup -a claude-code twice, then open ~/.claude/skills/argent-ios-simulator-setup/SKILL.md.

What does this skill do?

It finds a booted iOS simulator via list-devices, boots a specific device with boot-device, and prepares it for interaction using argent MCP tools.

Do sub-agents need special permissions?

Yes. If you assign simulator tasks to sub-agents, make sure they have access to MCP-permissions to use argent tools.

Source text

SKILL.md · Apache-2.0
---
name: argent-ios-simulator-setup
description: Set up and connect to an iOS simulator using argent MCP tools. Use when starting a new session, booting an iOS simulator, getting an iOS UDID, or before any iOS simulator interaction task.
---

## 1. Setup Steps

If you delegate simulator tasks to sub-agents, make sure they have MCP permissions.

1. **Find a booted simulator**
   Use `list-devices`. Filter for entries with `platform: "ios"` and skip any with `kind: "device"` (a physical iPhone, never a simulator target): booted simulators are listed first.
   If none are booted, call `boot-device` with `udid: <chosen UDID>`.

2. **Verify connection**
   All interaction tools (`gesture-tap`, `gesture-swipe`, `gesture-custom`, etc.) auto-start the server if not already running.

## 2. Notes

- UDIDs look like: `A1B2C3D4-E5F6-7890-ABCD-EF1234567890`

© software-mansion · Apache-2.0 · software-mansion/argent

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