simctl-plus

A command-line tool for iOS simulator and virtual machine management.

Features

Simulator Management

• List available simulators
• Boot/shutdown simulators
• Install/uninstall apps
• Take screenshots
• Record video
• Generate diagnostic reports
• Measure startup times

Virtual Machine Management

• Create custom VMs
• Start/stop VMs
• List available VMs
• VM diagnostics and monitoring

Installation

Requirements

• macOS 12.0 or later
• Xcode 13.0 or later
• Swift 5.5 or later

Building from Source

1. Clone the repository:

git clone https://github.com/mastersam07/simctl-plus.git
cd simctl-plus

2. Build the project:

./sign.sh

3. Install the binary:

cp .build/release/simctl-plus /usr/local/bin/

Usage

Simulator Commands

List available simulators:

simctl-plus simulator list

Boot a simulator:

simctl-plus simulator boot <device-id>

Install an app:

simctl-plus simulator install <device-id> <app-path>

Generate diagnostics:

simctl-plus simulator diagnose <device-id>

VM Commands

Create a new VM:

simctl-plus vm create --name my-vm --memory 4 --cpu 2

Start a VM:

simctl-plus vm start my-vm

List VMs:

simctl-plus vm list

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• ArgumentParser - Apple's framework for command-line argument parsing

• Virtualization Framework - Apple's framework for virtual machine management