Simulator
Apps & AutomationsimulatorSimulator is an Agent Skill for apps & automation published in the woocommerce/woocommerce-ios repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Discover and boot an iOS simulator. Use before any command that needs a simulator UDID.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/woocommerce/woocommerce-ios/blob/HEAD/.claude/skills/simulator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/simulator, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Discover and Boot iOS Simulator
Find a booted simulator or boot one. Returns the UDID for use in subsequent commands. Defaults to iPhone; pass ipad to use an iPad instead.
Never hardcode a simulator name (e.g., iPhone 16). Available simulators change across Xcode versions — always discover dynamically.
Usage
Run the script:
# iPhone (default):
UDID=$(Scripts/find-simulator.sh iphone)
# iPad:
UDID=$(Scripts/find-simulator.sh ipad)
The script prints the UDID to stdout and status messages to stderr. It will boot a simulator if none is already running.
Output
Report the simulator name and UDID so the caller can use it:
Simulator ready: iPhone 17 (93E9F784-2B91-4D83-BFA5-F1682C28180B)
Watch
Watch app verification is not supported — the Watch app runs on a separate watchOS simulator with a different build destination (watchOS Simulator). It cannot be tested via the iPhone/iPad iOS simulator used for app verification.