PluginBench
Skill
Pass
Audit score 90

argent-ios-simulator-setup

software-mansion/argent

Set up and connect to iOS simulators using argent MCP tools for automated testing and interaction.

What is argent-ios-simulator-setup?

Initializes iOS simulator environments and establishes connections via argent MCP tools. Use this skill when starting a new session, booting a simulator, obtaining a UDID, or before performing any iOS simulator interaction tasks.

  • List available iOS simulators and identify booted devices
  • Boot inactive iOS simulators by UDID
  • Verify simulator connectivity before interaction tasks
  • Auto-start the interaction server on first gesture or interaction call
  • Manage MCP permissions for delegated simulator tasks

How to install argent-ios-simulator-setup

npx skills add https://github.com/software-mansion/argent --skill argent-ios-simulator-setup
Prerequisites
  • argent MCP tools installed and accessible
  • iOS simulator(s) available on the host machine
  • MCP permissions configured if delegating to sub-agents
Claude Code
Cursor
Windsurf
Cline

How to use argent-ios-simulator-setup

  1. 1.Call list-devices to enumerate available iOS simulators and identify booted instances
  2. 2.If no simulator is booted, call boot-device with the target UDID
  3. 3.Verify connection by checking that the interaction server is ready (auto-starts on first interaction call)
  4. 4.Proceed with gesture or interaction tasks; the server will initialize automatically if needed
  5. 5.If delegating to sub-agents, ensure they have appropriate MCP permissions

Use cases

Good for
  • Starting a new iOS testing session with a fresh simulator environment
  • Booting a specific iPhone simulator before running automated UI tests
  • Obtaining the UDID of an active simulator for scripting or CI/CD pipelines
  • Verifying simulator readiness before delegating interaction tasks to sub-agents
  • Setting up multiple simulator instances for parallel testing workflows
Who it's for
  • iOS developers automating simulator interactions
  • QA engineers running iOS UI tests
  • CI/CD pipeline maintainers managing simulator environments
  • Agents delegating simulator tasks to sub-agents

argent-ios-simulator-setup FAQ

What does a UDID look like?

UDIDs are formatted as: A1B2C3D4-E5F6-7890-ABCD-EF1234567890

Do I need to manually start the interaction server?

No. All interaction tools (gesture-tap, gesture-swipe, gesture-custom, etc.) automatically start the server if it is not already running.

What should I do if no simulator is booted?

Use the boot-device tool with the UDID of the simulator you want to start.

Can I delegate simulator tasks to sub-agents?

Yes, but ensure they have MCP permissions configured before delegating.

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.

  1. Find a booted simulator Use list-devices. Filter for entries with platform: "ios" — booted iPhones 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