[Purpose] Oh My Android is positioned as the missing control panel for Android emulators on macOS. It is a free Mac ADB graphical interface tool aimed at Android developers and QA testers. It replaces repetitive testing chores: toggling dark mode, enlarging fonts, switching to Arabic to check RTL, enabling TalkBack, throttling the network to 3G, clearing app data, taking screenshots, and so on. These operations were originally hidden in emulator settings or required repeatedly looking up adb shell commands; now they are all gathered in a floating panel beside the emulator, where each icon shows the device's real state and a single click changes it.
[Main capabilities]
- Nearly 50 everyday testing operations are completed with one click, covering emulators and physical devices connected via USB or Wi-Fi adb.
- Layout inspector: freeze the screen and measure in a Figma-like way, with support for Jetpack Compose and classic Views; hover to view an element's dp dimensions, and click one element then hover another to view spacing (spacing between sibling elements, parent container padding); provides an 8 dp grid, a color picker (hex, ⇧⌘C to copy), and estimated sp font size.
- Design overlay: drag in a Figma PNG export, choose 1× / 2× / 3× or fit width, set opacity or difference blending, fine-tune with the arrow keys, and compare design and implementation pixel by pixel.
- Accessibility audit: in the layout inspector, press ⇧⌘A to number each screen reader stop in roughly TalkBack order, show what TalkBack will read aloud, and list issues such as unlabeled buttons, images missing content descriptions, and touch targets smaller than 48 × 48 dp.
- Data inspector: browse any debuggable app's SharedPreferences (keys, types, values) and SQLite databases (tables, first 500 rows), with search support; it uses the same adb shell run-as permissions as Android Studio, so release builds remain closed, and it is read-only and does not change device contents.
- Settings such as dark mode, font size, Arabic RTL, incoming calls, and SMS can all be toggled with one click; the network menu provides profiles such as LTE, HSDPA, 3G, EDGE, GPRS, and GSM, setting both speed and latency.
[AI agents (MCP)] A built-in MCP server lets AI proThe agent can see and drive the emulator: take screenshots, read the UI tree in dp, tap and type, toggle dark mode or RTL, and read logcat and app databases. The agent can build the interface itself, run it, view the results, and fix it. It supports any agent that uses MCP over stdio, such as Claude Code, Claude Desktop, Codex CLI, Cursor, VS Code (GitHub Copilot), Windsurf, Gemini CLI, JetBrains AI, Zed, etc. The app does not need to be open; the agent starts the server when needed. Installation methods include: Homebrew path /opt/homebrew/bin/ohmyandroid-mcp; menu bar icon → AI Agents → Set Up… to choose an agent and copy or add it to Cursor / VS Code; Claude Code plugin (/plugin marketplace add ateymoori/oh-my-android, then /plugin install oh-my-android@oh-my-android); Claude Desktop extension (open oh-my-android-<version>.mcpb from the latest release); listed in the MCP Registry as io.github.ateymoori/oh-my-android. Permissions can be controlled via the menu bar icon → AI Agents → Off / Read only / Full control. The server checks on every call, and changes take effect immediately; tools that may lose data are marked as destructive, and the agent must ask first.
【Installation and Usage】 Install with Homebrew: brew install --cask ateymoori/tap/oh-my-android; you can also download the zip from the latest release, unzip it, and move Oh My Android.app into Applications. The app is signed and notarized by Apple. When updating, a dot appears on the menu bar icon; click Update to … to view what's new and install with one click. The app will never update without asking; it checks once a day and can be turned off in Settings → Updates; brew upgrade --cask oh-my-android also works. System requirements are macOS 26 Tahoe or later, Apple silicon, and the Android SDK from Android Studio (or brew install --cask android-commandlinetools). The app automatically finds the SDK; if it is in a special folder, you can select it in Settings → Android SDK.
【Privacy and Security】 No analytics, no telemetry, no account; the only network request it makes on its own is the update check, which reads a small feed of this project's GitHub releases once a day and sends no information about you or your device; it can be turned off in settings. Updates are installed only when you choose, and must use this project's EdDSA key and the same Developer ID signature. It communicates only with adb from its own Android SDK, and entered text is shell-quote-escaped before reaching the device. Database copies in the data inspector are deleted on reload and when the app quits. The MCP server runs only when started by an AI agent and with the permissions you allow; the screens, UI, logs, and app data it reads are passed to the agent, and from there to the agent's model provider. The app is signed with a Developer ID, uses the hardened runtime, and is notarized by Apple.
【Limitations】 It is currently a native macOS app and no versions for other platforms are provided; because Mac App Store apps must run in the App Sandbox and sandboxed apps cannot launch adb, it is distributed only via Homebrew and GitHub. The panel uses new macOS 26 Tahoe APIs such as Liquid Glass, so older systems cannot use it. It does not bundle an emulator or SDK; it merely controls Google emulators and physical devices through your existing Android SDK; emulator-only features such as GPS, battery, incoming calls, SMS, snapshots, network speed, and screen recording require an emulator. The official text does not mention pricing details beyond the charging model, nor does it provide language support information for any languages other than those mentioned above.
