Skip to main content
Manage the headless simulators that mobster verify and mobster mcp run on: list them, prepare one (create, boot, build and start WebDriverAgent), shut them down, erase or delete them. It deletes only simulators Mobster created.

Usage

Commands

mobster sim list

List the simulators Mobster created, with their state and WebDriverAgent address.

Options

mobster sim release

Ask each mobster mcp server started by the same app as this shell, such as the agent that runs this command, to release the simulator it holds. It lets go at its next sweep, within 15 seconds. A simulator another app’s agent holds is left alone.

Options

mobster sim prepare

Create the simulator if needed, boot it headless, build WebDriverAgent the first time, start it on 127.0.0.1, and print how long each phase took. It stays up afterwards.

Options

mobster sim biometric

Read or change biometric enrollment, or send a Face ID or Touch ID test event to an idle, booted Mobster simulator. Real devices are never supported. A sent event does not confirm that the app authenticated.

Arguments and options

mobster sim shutdown

Stop WebDriverAgent and shut down every Mobster simulator that isn’t running a check, or the one named.

Arguments

mobster sim erase

Shut down and erase one Mobster simulator: its apps and data go, and the next run boots it fresh.

Arguments

mobster sim delete

Shut down and delete Mobster’s simulators. Only UDIDs in Mobster’s registry whose names start with “Mobster · ” are deleted; any other UDID is refused.

Arguments and options

UDID and --all can’t be used together; one is required.

mobster sim prune

Delete Mobster simulators unused for 14 days, WebDriverAgent builds for Xcode versions no longer installed, and registry entries for simulators that are gone.

Options

mobster sim doctor

Check Xcode, the iOS runtime, the device type, git, disk space, WebDriverAgent, Mobster’s simulators, ports, and your OpenAI or Anthropic key for Smart, and print the fix for each problem. It never runs sudo and never downloads a runtime.

Options