argent-ios-simulator-setup
software-mansion/argent
Set up and boot iOS simulators, verify connection, and obtain UDIDs for simulator interaction tasks.
What is argent-ios-simulator-setup?
Configures iOS simulator environments using argent MCP tools. Use this skill when starting a new session, booting a simulator, retrieving device identifiers, or before performing any iOS simulator interactions.
- List available iOS simulators and filter for booted instances
- Boot an iOS simulator by UDID if none are currently running
- Verify simulator connection and auto-start the interaction server
- Retrieve iOS simulator UDIDs for targeting specific devices
- Prepare the environment for sub-agent simulator task delegation
How to install argent-ios-simulator-setup
npx skills add https://github.com/software-mansion/argent --skill argent-ios-simulator-setup- argent MCP tools installed and accessible
- Xcode with iOS simulator support installed
- MCP permissions configured for any sub-agents that will interact with simulators
How to use argent-ios-simulator-setup
- 1.Call `list-devices` and filter results for `platform: "ios"` entries, excluding `kind: "device"` (physical devices)
- 2.If no booted simulator appears in the list, call `boot-device` with the target simulator's UDID
- 3.Verify connection by confirming the server auto-starts when you call any interaction tool like `gesture-tap` or `gesture-swipe`
- 4.Use the obtained UDID in subsequent simulator interaction commands
Use cases
- Initialize a new iOS testing session by booting the first available simulator
- Obtain a specific simulator's UDID for use in downstream automation tasks
- Verify simulator connectivity before running gesture or interaction commands
- Set up MCP permissions for sub-agents that will handle simulator interactions
- Switch between multiple simulators by listing devices and booting a different UDID
- iOS developers automating simulator testing
- QA engineers setting up test environments
- Agents delegating iOS simulator tasks to sub-agents
- Mobile app developers needing programmatic simulator control
argent-ios-simulator-setup FAQ
Booted simulators appear first in the `list-devices` output with `platform: "ios"`. Exclude any entries with `kind: "device"`, which represent physical iPhones, not simulators.
Call `boot-device` with the UDID of the simulator you want to start. UDIDs follow the format `A1B2C3D4-E5F6-7890-ABCD-EF1234567890`.
No. All interaction tools (`gesture-tap`, `gesture-swipe`, `gesture-custom`, etc.) automatically start the server if it is not already running.
Sub-agents must have MCP permissions configured to access the argent simulator tools if you delegate simulator tasks to them.
Full instructions (SKILL.md)
Source of truth, from software-mansion/argent.
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.
-
Find a booted simulator Use
list-devices. Filter for entries withplatform: "ios"and skip any withkind: "device"(a physical iPhone, never a simulator target): booted simulators are listed first. If none are booted, callboot-devicewithudid: <chosen UDID>. -
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
Related skills
More from software-mansion/argent and the wider catalog.
argent-lens
Propose and compare multiple visual design variants for UI elements with human selection.
argent-metro-debugger
Debug React Native and Chromium apps via Chrome DevTools Protocol with Metro and CDP integration.
argent-native-profiler
Native profiling for iOS and Android: CPU hotspots, UI hangs, memory leaks via xctrace and Perfetto.
argent-qa-flows
Create repeatable QA regression E2E tests as Argent flows from test cases and acceptance criteria.
argent-react-native-app-workflow
Step-by-step workflows for developing and debugging React Native apps on iOS simulator or Android emulator.
argent-react-native-optimization
Profile React Native apps to find real bottlenecks, then fix mechanical issues systematically.