← Projects
Open source

sim-crafter-cli

Minimal simctl wrapper — list, create, boot and screenshot iOS simulators from your terminal

Documentation →GitHub ↗

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