mcpField
M
mobile-harness

mobile-harness

github.com/droidrunAgent workflows42176 installsUpdated 1w ago
Repository

About mobile-harness

mobile-harness is an agent skill for controlling Android and iOS devices through Mobilerun. It guides agents to the relevant platform instructions and provides a common Mobilerun control model for cloud and local devices.

Key features

  1. 01Android and iOS device control
  2. 02Mobilerun connection setup
  3. 03Platform-specific guide routing
  4. 04Cloud and local device support

Use cases

  1. 01Automating tasks on Android devices
  2. 02Automating tasks on iOS devices
  3. 03Selecting platform instructions for a task

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/droidrun/mobile-harness --skill mobile-harness

After installing, type/mobile-harnessin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
README.md
.gitignore
LICENSE
UPDATE.md
install.md
.claude-plugin/
plugin.json
marketplace.json
apps/
index.md
apps/android/com.android.chrome/
CARD.md
apps/android/com.android.settings/
CARD.md
apps/android/com.ebay.mobile/
CARD.md
apps/android/com.google.android.gm/
CARD.md
apps/ios/com.apple.mobilesafari/
CARD.md
apps/ios/com.apple.Preferences/
CARD.md
core/credentials/
GUIDE.md
core/memory/
GUIDE.md
local/
README.md
local/credentials/
README.md
TEMPLATE.md
local/memory/
README.md
platforms/android/
GUIDE.md
platforms/android/recovery/
GUIDE.md
platforms/ios/
GUIDE.md
platforms/ios/recovery/
GUIDE.md

Details

From the project README

mobile-harness

Use this harness when an agent needs to control Android or iOS devices through Mobilerun.

Start by reading AGENTS.md. It routes you to the smallest platform file for the current task.

Paths

When Claude Code loads this skill from a plugin, it fills in:

  • <harness-root>: ${CLAUDE_PLUGIN_ROOT}
  • <state-root>: ${CLAUDE_PLUGIN_DATA}

If those still read as ${...} placeholders, <harness-root> and <state-root> are both the directory containing this file.

Primary Control Model

Normal device control always uses:

from mobilerun_core import Mobilerun

Use Mobilerun() to connect to cloud devices, local Android ADB with optional Portal, local Android Portal HTTP-only, or local iOS HTTP (mobilerun-ios for USB iPhones, ios-portal for Simulators). Do not import or call mobilerun_core_local directly for normal agent work. mobilerun-core-local is the local-driver dependency used internally by mobilerun-core for Android and iOS local backends.

Load Order

  1. Read AGENTS.md.
  2. Read platforms/android/GUIDE.md for Android work.
  3. Read platforms/ios/GUIDE.md for iOS work.
  4. Read recovery, credentials, memory, and app-card files only when routed there by AGENTS.md or the platform guide.

For setup and runtime registration, read install.md.

Comments

Markdown supported