👋 Introduction

sim-crafter-cli is a thin, friendly wrapper around xcrun simctl. It turns the verbose simulator commands you can never remember into a handful of interactive prompts, so listing, creating, deleting, booting, and screenshotting iOS simulators all happen straight from the terminal.

It is built for the day-to-day testing and development loop on macOS: no Xcode GUI, no UDIDs to copy and paste — just pick from a list and go.

✨ Features

• List simulators — display all installed simulators with their OS version, UDID, state, and availability in a clean table.
• List device types — browse every simulator device type available to create, with its identifier and min/max runtime versions.
• Create simulators — pick a device type and iOS runtime from interactive prompts; the tool suggests a sensible default name.
• Delete simulators — multi-select the simulators you want gone, with a confirmation step before anything is removed.
• Boot simulators — start any available, non-booted simulator from a list.
• Take screenshots — capture a screenshot from a booted simulator and save it wherever you like.

✅ Requirements

• macOS with Xcode and its command-line tools installed (the tool shells out to xcrun simctl).
• Node.js to run the CLI.

📦 Install

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

This installs the sim-crafter command globally.

🚀 Quick start

List the simulators you already have installed:

sim-crafter list

Create a new one, following the interactive prompts:

sim-crafter create

Boot it up:

sim-crafter boot

Head to Commands for the full reference of every subcommand.