⌨️ Commands

Every command is invoked as sim-crafter <command>. Most commands are interactive: they fetch the relevant simulators or device types and present them as a selectable list, so you never need to handle UDIDs by hand.

sim-crafter <command>

Run sim-crafter --help to see the command list, or sim-crafter --version to print the installed version.

📋 list

List all simulators installed on your machine. Results are grouped and sorted by iOS runtime (newest first) and rendered as a table showing each device's name, OS version, UDID, state, and availability.

sim-crafter list

If no simulators are found, the tool suggests creating one with the create command.

📱 list-remote

List every simulator device type available to create — the templates you can build a new simulator from. The table shows each device type's name, identifier, and its minimum and maximum supported runtime versions.

sim-crafter list-remote

➕ create

Create a new simulator. The command walks you through two interactive prompts:

1. Choose the device type — picked from the available device types.
2. Choose the iOS runtime — picked from the installed runtimes.

It then suggests a default name in the form <device> - <iOS version>, which you can accept or override.

sim-crafter create

If the chosen device type and runtime are incompatible, the tool reports the mismatch and asks you to try a different combination.

🗑️ delete

Delete one or more simulators. You are shown a multi-select checkbox list of every simulator (labelled with name, iOS version, and UDID), followed by a confirmation prompt. Nothing is removed unless you confirm.

sim-crafter delete

Deletion is cancelled if you decline the confirmation or select nothing.

⚡ boot

Boot a simulator. The list is filtered to simulators that are available and not already booted; pick one and it starts.

sim-crafter boot

📸 screenshot

Capture a screenshot from a booted simulator. The list is filtered to simulators that are currently Booted. After choosing one, you are prompted for the save path — include the file name and extension (for example ~/Desktop/shot.png).

sim-crafter screenshot

The screenshot is written to the path you provide.