Android Simulator RS

Local Android emulator control panel designed to run standalone and inside Codex's existing Browser sidebar.

This is unofficial. It does not patch Codex, does not depend on Codex++, and uses only documented Android SDK, Android Emulator, and ADB CLI behavior.

Requirements

• Rust 1.75+ for source builds, or a release binary
• Android SDK with platform-tools and emulator
• At least one Android Virtual Device

Recommended shell setup:

export ANDROID_HOME="$HOME/Library/Android/sdk"
export ANDROID_SDK_ROOT="$ANDROID_HOME"
export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"

Run

cargo build --release
./target/release/android-simulator-rs serve --host 127.0.0.1 --port 47831

Open http://127.0.0.1:47831. In Codex, open the Browser sidebar and navigate to the same URL.

MCP

Run android-simulator-rs mcp to expose safe structured Android tools for agents.

Test

cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test && cargo llvm-cov --all-targets --ignore-filename-regex 'src/main.rs' --fail-under-lines 90

Optional real emulator smoke checks are manual for now. See docs/TESTING.md.

Inspiration

This project credits Baguette by tddworks as inspiration for the local simulator control-panel concept and testable lifecycle architecture. This project is an independent Android implementation using documented Android SDK and ADB tooling only.