Skip to content

custardcream98/simux

Repository files navigation

simux

A friendly simctl wrapper to list, create, boot, rename and delete iOS Simulators — with an interactive UI, nice colors, and quality-of-life shortcuts.

demo

Features

  • List simulators grouped by Booted/Other, with OS version tags
  • Colorized labels, device icons, booted green dot
  • Interactive menu with paging (arrow-key scroll via less) and cancel support
  • Create device (choose type/runtime, name), optional auto-boot + open Simulator
  • Boot, Rename, Delete with confirmation and cancel
  • JSON-driven parsing of simctl for robust OS/runtime info

Requirements

  • macOS with Xcode Command Line Tools (provides xcrun simctl)
  • Node.js >= 18

Install

# Local (project)
pnpm add -D simux

# Or globally
pnpm add -g simux

Usage

# Interactive menu
simux

# List devices (non-interactive)
simux list

# Rename a device (non-interactive)
simux rename <UDID> "New Name"

# Delete a device (non-interactive)
simux delete <UDID>

# Boot a device
simux boot <UDID>
# Without UDID provided, the interactive picker opens

About

A friendly simctl wrapper to list, create, boot, rename and delete iOS Simulators.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published