AI-native UI automation for the iOS Simulator, the Android Emulator, and — once registered — physical iPhones and Android devices. Written in Rust; distributed as a CLI (smix), a Rust SDK, and native SDKs for Swift and Kotlin. A TypeScript package ships the same typed API surface and drives a device through the napi addon; three surfaces (App.screenshot, App.openUrl, App.launchFresh) still throw SmixNotImplementedError pending their transport — see the npm package README.

Designed for LLM-authored test flows:

• Explicit selectors (id / text / label / role / anchor) — no XPath, no coordinate guessing
• AI-readable failure messages with visible-element context and edit-distance suggestions
• Playwright-shape API surface mirrored across the SDKs
• Host-side selector resolution + native event injection (IOHID + XCUIElement chain on iOS, UiAutomator on Android)
• MCP server entry for direct Claude Code integration
• Physical devices are a first-class target, held to three rules: a device must be registered before it can be addressed (so "whichever phone is plugged in" is never one), destructive actions are refused per device until allowed once, and a capability a phone does not have is a loud error, never a silent no-op

Pick the SDK that matches your test harness. All ship the same wire-level primitives.

# CLI + MCP server, prebuilt — no Rust toolchain needed
npm install -g @goliapkg/smix-cli

# Rust CLI + SDK, from source
cargo install smix-cli --locked

# Swift Package Manager
# add https://github.com/goliajp/smix (product: SmixSDK, from: "10.0.0")

# Gradle / Maven (Kotlin / Java)
# implementation("jp.golia.smix:smix-sdk:10.0.0")

# Optional, Android only, debug builds only: lets smix read Compose's own
# semantics tree instead of the accessibility projection of it, so a control
# inside a dialog can be addressed by id. Everything works without it.
# debugImplementation("jp.golia.smix:smix-probe:10.0.0")

# TypeScript / Node / Bun (drives a simulator through the native addon)
npm install @goliapkg/smix

Prerequisites: macOS with Xcode + Simulator (iOS testing); Android SDK with an emulator image (Android testing). For a physical device, USB and a paired phone — plus, on iOS, an Apple Development signing identity and a phone that stays unlocked, because a locked one parks xcodebuild rather than failing it.

Coming from 3.x? Device records and leases moved to the machine, so one checkout no longer holds answers the next cannot see. Run smix sim migrate and smix lease migrate once — they copy and never remove — and read Migrating to smix 4.0 if you call the Rust crates: two signatures changed.

Register a dedicated device for your project, then run a YAML flow — smix run needs no --device after that, because smix init records the project's default (omit --alias and it is derived from the project directory's name):

smix doctor                                       # says what is missing, and the command for it
smix init --alias dev --device <UDID> --app ./MyApp.app  # registers this project's device, installs the app
smix capsule up dev --bundle <your.bundle.id>     # boots it and starts the runner
smix run examples/hello.yaml                       # no --device: resolves the project's default

smix doctor prints the next command at every point along that sequence, so the order above is what it walks you through rather than something to memorise.

Equivalent Rust SDK:

use smix_sdk::{App, text, KeyName};
use std::time::Duration;

let udid = std::env::var("SMIX_UDID").expect("SMIX_UDID env var required");
let app = App::connect_to_runner(22087, Some(&udid)).await?
    .with_bundle_id("com.example.app");
app.launch("com.example.app").await?;
app.wait_for(&text("Dashboard"), Duration::from_secs(5)).await?;
app.tap(&text("Sign In")).await?;
app.fill(&text("Email"), "user@example.com").await?;
app.press_key(KeyName::Return).await?;
app.assert_visible(&text("Dashboard")).await?;

The TypeScript package declares the same shape and drives through the napi addon, which Smix.launchApp loads for the running platform. App.screenshot, App.openUrl and App.launchFresh are the three that still throw SmixNotImplementedError, each waiting on a transport of its own.

See docs/ai-guide/01-quickstart.md for a full walkthrough.

Registration is the deliberate act — it is what makes the device addressable at all, and nothing on this machine can enumerate the world's phones to check it for you:

smix sim register phone --udid <UDID> --kind physical-ios
smix runner up phone --bundle com.example.app     # --team <TEAM_ID> if you have more than one
smix sim screenshot phone shot.png                # served by the runner; a phone has no other way to be seen

Erasing, uninstalling and keychain resets are refused on it until smix sim allow-destructive phone — recorded once, not confirmed per command, because a confirmation typed every time ends up pasted into a script.

Full surface: docs/ai-guide/05-cli.md.

smix follows semantic versioning at the wire, ABI, and CLI surface.

• Wire format — versioned by schema negotiation: the runner answers GET /health with the schema versions it speaks (currently [1, 2]), and each client negotiates the newest both ends share. Any change that would break a spoken schema adds a new version instead.
• Stone crate ABI — the core crates (smix-error, smix-selector, smix-screen, smix-runner-wire, smix-input, smix-verbs, smix-metro-log, smix-fixture, smix-annotate, smix-migrate) are ABI-stable within the 2.x series; additive changes only. cargo-semver-checks gates every release.
• CLI surface — smix run flags shipped in 2.0 remain accepted for the 2.x lifetime.
• YAML verb parity — the verb table is a single source of truth (smix-verbs). Removing a verb is a major-version change.

Compatibility matrix:

This project does not accept external contributions. See CONTRIBUTING.md for the full policy.

The source is published under Apache 2.0 / MIT so you are free to fork, adapt, and redistribute per those license terms; upstream will not accept pull requests, feature requests, or issue reports.

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.