v0.1.0
NeoSimulator v0.1.0
The project is now named NeoSimulator. The xcode-simulator-host command remains unchanged.
Apple’s Simulator.app from Xcode 26 remains the recommended host for Xcode 27+. Both direct-host modes use undocumented Xcode preferences. The bundled NeoSimulator host is currently in beta and additionally uses undocumented Apple frameworks.
Install or update:
curl -fsSL https://github.com/lynnswap/NeoSimulator/releases/latest/download/install.sh | shBreaking Changes
- The release archive is now named
NeoSimulator-darwin-arm64.tar.gzand contains both the CLI and the companion app. Integrations that download or extract the archive directly must update the asset name and preserve itsbinandlibexeclayout. The installed command remainsxcode-simulator-host.
New Features
- Add
xcode-simulator-host use neo, a bundled standalone host that does not require Xcode 26. It provides resizable windows for booted iOS simulators, touch and keyboard input, accessibility, screenshots, rotation, appearance controls, and Simulator-style menus.
Improvements
- Accept Xcode 27 and later when the selected installation and required compatibility surfaces pass validation. Incompatible Neo environments fail closed without falling back to Device Hub.
- Coordinate NeoSimulator, Legacy Simulator, and Device Hub process ownership when switching or restoring simulator routes.
- Make
xcode-simulator-host statusa compact, Xcode-independent route check. Usestatus --verbosefor installation details, compatibility-checked components, preferences, restoration state, and running processes. - Install the CLI and companion app as a verified pair, with rollback if an update is interrupted.
Migration Notes
- Re-run the installer to add the companion app. Existing preference state and restoration receipts do not require migration.
- Custom
--bindirinstallations placeNeoSimulator.appunder the physical bindir parent atlibexec/xcode-simulator-host/NeoSimulator.app.
Documentation
- Add guides for advanced configuration, Simulator.app behavior, and the NeoSimulator standalone-host contract.
Full Changelog: v0.0.1...v0.1.0