Opencode-Demul

View and control Android emulators from OpenCode Desktop on Windows, Linux, and macOS, and iOS simulators on macOS.

Requirements

• OpenCode Desktop compatible with plugin SDK 2.2.2, using a local server.
• Node 22.19+ on the 22.x line, or Node 24+, with npm.
• Android SDK Platform-Tools and Emulator, a configured Android Virtual Device, and hardware virtualization enabled.
• For iOS (macOS only): Xcode with an iOS Simulator runtime, selected with xcode-select.

Set ANDROID_HOME or ANDROID_SDK_ROOT if your SDK is outside the standard Android Studio location. Set OPENCODE_DEVICE_NODE to your Node executable if the desktop cannot find it.

Install

Add this entry to your OpenCode configuration.

{
  "plugins": ["github:viralcodex/opencode-demul#v0.3.0"]
}

Open Add tab > Device in a session. First use downloads the pinned device helpers from npm. Android SDK tools and Node must already be installed. Android video uses the device's H.264 encoder through scrcpy.

Use

The panel opens the first available running device, or else the first available listed one, and starts it if needed. Use the platform and device pickers to switch between Android emulators and iOS simulators, and refresh to rescan. Either platform's toolchain may be missing; the picker lists what the host can run.

Discovery and startup run in the background. The controls remain available while a device boots; selecting another device cancels the pending attachment.

Each session controls its own device. Run iOS and Android side by side in separate sessions; a device already controlled by another session cannot be attached. Tabs and windows showing the same session share its device and agent-access setting. Closing a viewer stops its video without detaching the device, so agents can keep working. Use device.close to release it; deleting or moving the session also releases it. A failed device switch keeps the previous attachment.

Agent access starts enabled. Use the switch to revoke access for the current session. Agents can only use a device you have opened. Installing an app or shutting down a device requires a separate permission prompt.

Tools use device_* names, or device.* in Code Mode. They can inspect the screen, launch apps, enter text, interact with elements and take screenshots.

The first iOS automation command builds the agent's XCTest runner, which can take a few minutes. [Physical devices, remote servers and direct keyboard input into the panel coming soon.]

Prebuilt plugin files are included.

Release notes for v0.3.0.

Development

Use Bun 1.3.6 and a supported Node version to build and test it.

bun install --frozen-lockfile
bun run check
bun run bundle
bun run verify:package

MIT license. Dependency licenses are listed in THIRD_PARTY_NOTICES.md.