# argent-ios-simulator-setup

Boots an iOS simulator and gets its UDID, so an agent can connect argent and start interacting with the app.

Skill by Software Mansion. Category: Testing.

## Install

Project (for this project only):

```sh
npx skills add software-mansion/argent --skill argent-ios-simulator-setup
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add software-mansion/argent --skill argent-ios-simulator-setup -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 22877. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/software-mansion/argent/argent-ios-simulator-setup)

## Source

[Open the source](https://github.com/software-mansion/argent/tree/HEAD/packages/skills/skills/argent-ios-simulator-setup). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

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

- Previous: [argent-react-native-optimization](https://syn4pse.dev/terminal/argent-react-native-optimization.md)
- Next: [argent-react-native-app-workflow](https://syn4pse.dev/terminal/argent-react-native-app-workflow.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
