https://github.com/mui-z/xsim
simple xcrun simctl wrapper.
https://github.com/mui-z/xsim
cli ios ios-simulators swift xcode
Last synced: about 1 month ago
JSON representation
simple xcrun simctl wrapper.
- Host: GitHub
- URL: https://github.com/mui-z/xsim
- Owner: mui-z
- License: other
- Created: 2025-08-23T05:40:28.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T09:41:02.000Z (6 months ago)
- Last Synced: 2025-10-06T11:33:01.256Z (6 months ago)
- Topics: cli, ios, ios-simulators, swift, xcode
- Language: Swift
- Homepage:
- Size: 142 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# XSim
[](https://github.com/apple/swift)
[](https://github.com/mui-z/xsim/blob/main/LICENSE)
simple xcrun simctl wrapper.
## Install
```sh
mint install mui-z/xsim
```
## Usage
```sh
% xsim help
Usage: xsim [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:
```sh
# 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:
```sh
# 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:
```sh
# default is full width (no truncation)
xsim list
# opt-in to truncated, aligned columns (legacy):
xsim list --truncate
```
Debug logging:
```sh
# enable verbose debug logs to stderr
XSIM_VERBOSE=1 xsim list
```
Boot convenience:
```sh
# 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:
```text
Running without a subcommand (just `xsim`) behaves the same as `xsim boot`.
```