simutil 1.1.0

TUI and CLI for launching Android emulators and iOS simulators, with ADB tools, Logcat viewer, and YAML plugins.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

1.1.0 - 2026-10-14

Added

• Android emulators and devices show their Android version (e.g. Android 15), like iOS simulators do.
• simutil launch --headless starts an emulator or simulator without its window.

Changed

• ADB tools: pairing with a QR code now works, and pairing with a code connects the device right away.
• The device list updates as soon as a device boots, shuts down, is plugged in or unplugged, instead of refreshing every 10 seconds.

1.0.1 - 2026-10-10

Fixed

• Android emulators and devices now show up on Windows.

1.0.0 - 2026-10-03

Added

• Command-line mode: simutil list, launch, shutdown, plugin list / plugin run, and simutil android … / simutil ios …. See simutil --help.
• simutil schema prints all commands as JSON for scripts and AI agents (--human for readable text).
• Update notice: when a new version is out, simutil shows it in the top-right corner and in simutil version, with a hint to run simutil upgrade. Turn off with SIMUTIL_NO_UPDATE_CHECK=1.
• simutil upgrade installs the latest version the same way you installed simutil (Homebrew, pub.dev, or the install script).

Changed

• Device lists load in the background, so the TUI stays responsive.
• For developers: simutil's code is now split into packages (simutil_core, simutil_adb, simutil_apple, simutil_plugins, simutil_shared). Replace package:simutil/services/... imports with them.

Fixed

• Wireless pairing: after 15 seconds with no results, a hint suggests pressing m to pair manually (your Wi-Fi may block discovery).
• Mistakes in plugin config are now reported instead of silently ignored.
• Windows: settings are saved in your user folder, not the current folder.
• simutil plugin run waits for interactive plugin commands and returns their exit code.
• First launch no longer risks losing your theme or plugin settings.
• The "What's New" dialog scrolls on the first arrow press.

0.9.0 - 2026-09-25

Fixed

• Open DeviceHub.app instead of Simulator.app when launching an iOS simulator on Xcode 27+. Older Xcode versions still open Simulator.app.
• Keep booted iOS simulators out of the physical device list. devicectl list devices includes them on Xcode 27, filtered with Reality = 'physical'.

0.8.1 - 2026-07-21

Fixed

• Stop resolving Xcode Derived Data under / when $HOME is missing; require an explicit home directory and fail clearly instead.

0.8.0 - 2026-07-21

Added

• Add confirmation dialog.
• Add Xcode Tools (x) with Clear Derived Data — measure size, confirm, then wipe ~/Library/Developer/Xcode/DerivedData (macOS only).

Fixed

• Fix background color of some dialogs.

0.7.0 - 2026-07-11

Added

• Add first-run Welcome and post-update Changelog dialogs backed by internal app state.

Changed

• Clarify in the README that iOS simulators and devices require macOS; Linux and Windows support Android only.

0.6.2 - 2026-07-08

Added

• Add Linux x64 support to the generated Homebrew formula.
• Add a release install smoke test that verifies packaged binaries before drafting a GitHub Release.

0.6.1 - 2026-07-07

Fixed

• Fix Android ADB discovery on Linux by checking $HOME/Android/Sdk and falling back to adb on PATH when no SDK-managed binary is present.
• Stop treating all Android physical devices as fully booted when adb devices -l reports intermediate states such as unauthorized or offline.
• Restore SSH terminal and TTY state on Linux after quitting remote sessions.

0.6.0 - 2026-06-26

Added

• Add custom plugin support via the plugins: section of ~/.simutil/settings.yaml: register external shell-command tools (each with one or more commands) and run them from the app with p (plugin → command → execute) or a direct command shortcut, without changing code.
• Add e key to open ~/.simutil/settings.yaml in the OS default editor (macOS, Linux, Windows).

Changed

• Route plugin availability probes through CommandExec instead of calling Process.run directly.
• Merge plugin configuration into ~/.simutil/settings.yaml (settings scalars + plugins: section in one file).
• Migrate the built-in scrcpy integration to the YAML plugin registry (a default config with scrcpy is generated on first launch).

Fixed

• Prevent device refresh from hanging forever when a simulator or device lookup stalls.
• Fix Device.fromJson reading the os field from the wrong key, which made deserialization always throw.

0.5.0 - 2026-05-02

Changed

• Add Windows PowerShell installer command (install.ps1) to README installation section.

• Refactor Wi-Fi pairing flow to match Android Studio: discover pairing-code endpoints first, require code entry after selecting a discovered device, then resolve and connect to the post-pair ADB connect endpoint.

Fixed

• Fix text color in dialogs and panels to avoid wrong overlay effect.

0.4.1 - 2026-04-11

Fixed

• Fix incorrect way to terminate app.

0.4.0 - 2026-04-05

Added

• Add Logcat dialog for launching Android emulators / devices.

0.3.2 - 2026-03-28

Fixed

• Fixed iOS devices discovery when device is not connected.
• Fixed dialogs and panels color

0.3.1 - 2026-03-26

Added

• Add macOS Intel support.

0.3.0 - 2026-03-23

Added

• Add shutdown action for Android emulators and iOS simulators.

Changed

• Change default keymap for launch and launch with option actions for Android emulators.

0.2.1 - 2026-03-21

Fixed

• Fix wrong focus when initializing app.

0.2.0 - 2026-03-21

Added

• Add iOS devices discovery.
• Add SelectionArea in Detail panel to allow user to select.

Changed

• ADB tools can be accessed from any panel.
• Replace Android emulator id with serial id when device is launching.

0.1.0 - 2026-03-20

Added

• Support Android physical devices

Changed

• Reopen ADB tools menu

0.0.4 - 2026-03-17

Changed

• Temporarily hide ADB Tools menu

Fixed

• Fix build error

0.0.3 - 2026-03-17

Changed

• Temporarily hide ADB Tools menu

0.0.2 - 2026-03-16

Added

• Add version command

0.0.1

Added

• Add conditional UI for iOS (only available on macOS)

Fixed

• Fix UI layout
• Fix idle message doesn't change when change panel

[0.0.1] - 2026-03-15

Added

• Initial release