Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 30 Aug 14:00
f01b54a

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 | sh

Breaking Changes

  • The release archive is now named NeoSimulator-darwin-arm64.tar.gz and contains both the CLI and the companion app. Integrations that download or extract the archive directly must update the asset name and preserve its bin and libexec layout. The installed command remains xcode-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 status a compact, Xcode-independent route check. Use status --verbose for 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 --bindir installations place NeoSimulator.app under the physical bindir parent at libexec/xcode-simulator-host/NeoSimulator.app.

Documentation

Full Changelog: v0.0.1...v0.1.0