Skip to content

mui-z/xsim

Repository files navigation

XSim

Swift LICENSE: MIT SUSHI-WARE🍣

simple xcrun simctl wrapper.

Install

mint install mui-z/xsim

Usage

% xsim help

Usage: xsim <command> [options]

Xcode Simulator management tool – shortcuts for simctl commands

Commands:
  list            List available simulators
  boot            Boot a simulator
  shutdown        Shutdown simulators
  create          Create a new simulator
  delete          Delete a simulator
  doctor          Check environment and simctl support
  help            Prints help information
  version         Prints the current version of this app

List filters and sorting:

# filter by runtime (flexible):
xsim list --runtime "iOS 26"
xsim list --runtime "26.0"
xsim list --runtime com.apple.CoreSimulator.SimRuntime.iOS-26-0

# runtimes are grouped and sorted by platform (iOS, watchOS, tvOS) and version (desc)

List filters and sorting:

# filter by runtime (flexible)
xsim list --runtime "iOS 26"
xsim list --runtime "26.0"
xsim list --runtime com.apple.CoreSimulator.SimRuntime.iOS-26-0

# filter by device name substring (case-insensitive)
xsim list --name-contains "iPhone"

# runtimes are grouped and sorted by platform (iOS, watchOS, tvOS) and version (desc)

Full width by default; compact view:

# default is full width (no truncation)
xsim list

# opt-in to truncated, aligned columns (legacy):
xsim list --truncate

Debug logging:

# enable verbose debug logs to stderr
XSIM_VERBOSE=1 xsim list

Boot convenience:

# Boot the most recently used simulator when none are running
xsim boot

# Boot a specific device by name or UUID
xsim boot "iPhone 15"
xsim boot 12345678-1234-1234-1234-123456789012

Note:

Running without a subcommand (just `xsim`) behaves the same as `xsim boot`.