A CLI tool to manage iOS simulators on macOS, simplifying testing and development workflows.

Website · Documentation

Features

• List simulators — display all local simulator devices in a table with OS version, UDID, and boot state
• Browse remote devices — list all available device types from Xcode with their identifier and runtime range
• Create simulators — interactively pick a device type and runtime to spin up a new simulator
• Delete simulators — select and remove an existing simulator device via an interactive prompt
• Boot on demand — start a simulator device ready for use without opening Xcode
• Take screenshots — capture a screenshot from any running simulator straight to disk

Install

npm install -g @kud/sim-crafter-cli

Requires macOS with Xcode installed. The tool wraps xcrun simctl and expects Node.js 18 or later.

Usage

$ sim-crafter list
┌──────────────────┬────────────┬──────────────────────────────────────┬────────┬───────────┐
│ Name             │ OS Version │ UDID                                 │ State  │ Available │
├──────────────────┼────────────┼──────────────────────────────────────┼────────┼───────────┤
│ iPhone 15 Pro    │ iOS 17.4   │ A1B2C3D4-…                           │ Booted │ Yes       │
│ iPhone SE (3rd)  │ iOS 17.4   │ E5F6G7H8-…                           │ Shutdown│ Yes      │
└──────────────────┴────────────┴──────────────────────────────────────┴────────┴───────────┘

$ sim-crafter create
$ sim-crafter boot
$ sim-crafter screenshot
$ sim-crafter delete
$ sim-crafter list-remote

Development

git clone https://github.com/kud/sim-crafter-cli.git
cd sim-crafter-cli
npm install
./index.js list

📚 Full documentation → sim-crafter-cli/docs