Install¶

You can use our interactive installer to step through all host platform requirements and configuration options. It checks host dependencies, optionally downloads Android or iOS developer tools, and configures the MCP daemon.

One-line install (click to copy)

curl -fsSL https://raw.githubusercontent.com/kaeawc/auto-mobile/main/scripts/install.sh | bash

Install Demo

Once you’ve finished that, learn how to use AutoMobile

Homebrew (macOS)¶

AutoMobile is published to the shared kaeawc/tap Homebrew tap on every tagged release. The formula installs the auto-mobile CLI and pulls in Bun as a runtime dependency.

Install via Homebrew

brew install kaeawc/tap/auto-mobile

Verify the install:

auto-mobile --cli help

Managed-device crash recovery¶

To let AutoMobile recover an owned virtual device after a mid-session process exit or confirmed disconnect, set this on the process that starts the daemon:

AUTOMOBILE_DEVICE_RECOVERY_ON_LOSS=1 \
AUTOMOBILE_DEVICE_RECOVERY_MAX_ATTEMPTS=2 \
auto-mobile --daemon restart

Only exact 1 enables recovery. The attempt budget is a strict integer from 1 to 10 and defaults to two. The legacy AUTOMOBILE_ANDROID_REBOOT_ON_DEATH=1 setting remains a compatibility fallback. AutoMobile recovers only virtual devices it started itself; physical devices and externally managed devices are never restarted.

Uninstalling¶

To remove AutoMobile and its configurations, use the uninstall script:

One-line uninstall (click to copy)

curl -fsSL https://raw.githubusercontent.com/kaeawc/auto-mobile/main/scripts/uninstall.sh | bash

See demo: Uninstall

Uninstall Demo