Mobilerun Docs Reference
droidrun/mobilerun
Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.
Gives an agent tap, swipe, screenshot, and app-launch control over local Android or iOS devices, or cloud devices, through one Python client.
Install Mobile Device Control Harness
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install droidrun/mobile-harness mobile-harness --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .claude/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install droidrun/mobile-harness mobile-harness --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .agents/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install droidrun/mobile-harness mobile-harness --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .cursor/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install droidrun/mobile-harness mobile-harness --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .gemini/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install droidrun/mobile-harness mobile-harnessInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .github/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add droidrun/mobile-harness --skill mobile-harness -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install droidrun/mobile-harness mobile-harness --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mobile-harness" agent skill from https://github.com/droidrun/mobile-harness/tree/main into .opencode/skills/mobile-harness/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobile-harness", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
mobile-harness- GitHub stars
- 394
- Token cost
- ~315 tokens
- SKILL.md length
- 130 words
- Files
- 41 (incl. assets)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
Gives an agent tap, swipe, screenshot, and app-launch control over local Android or iOS devices, or cloud devices, through one Python client.
- Works in 4 steps: Read AGENTS.md. → Read platforms/android/GUIDE.md for… → Read platforms/ios/GUIDE.md for iOS work. → …
- Automating taps and swipes on an Android or iOS device
- SKILL.md covers Primary Control Model and Load Order
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
This skill routes the agent through a single top-level file to the smallest relevant platform guide, then always connects through one client class that can target cloud devices, local Android over ADB with an optional companion app, local Android over HTTP only, or local iOS over HTTP; a lower-level local driver is never called directly.
It reads a platform guide for Android or iOS work as needed, and only opens recovery, credential, memory, or per-app card files when the top-level guide routes there. Setup and runtime registration are covered in a separate install file, and the skill ships per-app cards describing specific apps such as a browser, a settings app, and an email client.
When your agent uses it
- Automating taps and swipes on an Android or iOS device
- Taking screenshots or launching apps on a cloud phone
- Scripting a repeatable mobile UI flow for testing
Example prompts
- “Open the Settings app and toggle airplane mode on this Android device.”
- “Take a screenshot of the current screen on the cloud iPhone.”
- “Swipe through the onboarding screens in this app and confirm each step.”
Requirements
- A connected local Android (ADB) or iOS device, or a cloud device
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Read AGENTS.md.
- Read platforms/android/GUIDE.md for Android work.
- Read platforms/ios/GUIDE.md for iOS work.
- Read recovery, credentials, memory, and app-card files only when routed
What it can do on your machine
Read from SKILL.md and the folder at commit 254fd8d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Mobile Device Control Harness loads about 315 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 130 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from droidrun/mobile-harness at commit 254fd8d, republished under its MIT licence (© droidrun). 130 words, ~315 tokens.
Download SKILL.mdSave it as
.claude/skills/mobile-harness/SKILL.md (or your agent's skills folder). This skill also uses 40 other files; get the full folder from GitHub.- name
- mobile-harness
- description
- Portable Android and iOS device-control harness for agents. Use when an agent needs to control or automate Android/iOS devices — tap, swipe, screenshot, app control — locally (ADB/Portal/Simulator) or on Mobilerun cloud devices.
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.
Primary Control Model
Normal device control always uses:
from mobilerun_core import MobilerunUse Mobilerun() to connect to cloud devices, local Android ADB with optional
Portal, local Android Portal HTTP-only, or local iOS Portal HTTP. 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
- Read
AGENTS.md. - Read
platforms/android/GUIDE.mdfor Android work. - Read
platforms/ios/GUIDE.mdfor iOS work. - Read recovery, credentials, memory, and app-card files only when routed
there by
AGENTS.mdor the platform guide.
For setup and runtime registration, read install.md.
© droidrun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 40 other files (assets) in the repository root of droidrun/mobile-harness.
- SKILL.md
- .claude-plugin/plugin.json
- .gitignore
- AGENTS.md
- LICENSE
- README.md
- UPDATE.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/index.md
- apps/ios/com.apple.Preferences
- … and 28 more
Open the folder on GitHubat commit 254fd8d
Compare with similar skills
Mobile Device Control Harness next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Mobile Device Control Harness this skilldroidrun/mobile-harness | 394 | — | ~315 | Automated safety check: Pass | MIT | |
| Mobilerun Docs Referencedroidrun/mobilerun | 9.6k | — | ~943 | Automated safety check: Pass | MIT | |
| Appiumblokadaorg/blokada | 3.3k | — | ~3.5k | Automated safety check: Pass | MPL-2.0 | |
| Phoneagentrounak/PhoneAgent | 799 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Simvynpranshuchittora/simvyn | 438 | — | ~938 | Automated safety check: Pass | MIT | |
| Mobile Automation with agent-devicenuclearpasta/react-native-drax | 715 | — | ~1.4k | Automated safety check: Pass | MIT |
Similar skills
Appium
blokadaorg/blokada
A skill your agent uses for dynamic inspection and navigation of the Blokada app through the repo-local Appium machine session.
Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
Simvyn
pranshuchittora/simvyn
Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn.
Mobile Automation with agent-device
nuclearpasta/react-native-drax
Drives iOS and Android devices and simulators from the command line: open apps, snapshot the UI tree, tap, type, scroll, take screenshots and read UI info.
Device Log
blokadaorg/blokada
A skill your agent uses for pulling recent Blokada app logs from a connected device, using the same share-log file exposed in Settings.
Related
Categories
Questions about Mobile Device Control Harness
What does Mobile Device Control Harness do?
Gives an agent tap, swipe, screenshot, and app-launch control over local Android or iOS devices, or cloud devices, through one Python client. This skill routes the agent through a single top-level file to the smallest relevant platform guide, then always connects through one client class that can target cloud devices, local Android over ADB with an optional companion app, local Android over HTTP only, or local iOS over HTTP; a lower-level local driver is never called directly.
When should I use Mobile Device Control Harness?
Mobile Device Control Harness fits situations like: automating taps and swipes on an Android or iOS device; taking screenshots or launching apps on a cloud phone; scripting a repeatable mobile UI flow for testing.
How do I install Mobile Device Control Harness in Claude Code?
Run `npx skills add droidrun/mobile-harness --skill mobile-harness -a claude-code`. Or copy the skill folder (the droidrun/mobile-harness repository) into .claude/skills/mobile-harness in your project. Claude Code loads it when a task matches its description.
How do I install Mobile Device Control Harness in Codex?
Run `npx skills add droidrun/mobile-harness --skill mobile-harness -a codex`. Or copy the skill folder (the droidrun/mobile-harness repository) into .agents/skills/mobile-harness in your project. Codex loads it when a task matches its description.
Can I use Mobile Device Control Harness in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add droidrun/mobile-harness --skill mobile-harness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobile-harness, .gemini/skills/mobile-harness, .github/skills/mobile-harness and .opencode/skills/mobile-harness in your project.
What does Mobile Device Control Harness need to run?
SKILL.md names no scripts, command-line tools or credentials: Mobile Device Control Harness is instructions for the agent only. Our summary lists: A connected local Android (ADB) or iOS device, or a cloud device.
Does Mobile Device Control Harness access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Mobile Device Control Harness safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Mobile Device Control Harness use?
Mobile Device Control Harness is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Mobile Device Control Harness use?
About 315 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Mobile Device Control Harness?
Skills that share tags, products or a category with Mobile Device Control Harness: Mobilerun Docs Reference (droidrun/mobilerun, 9.6k stars), Appium (blokadaorg/blokada, 3.3k stars), Phoneagent (rounak/PhoneAgent, 799 stars) and Simvyn (pranshuchittora/simvyn, 438 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Mobile Device Control Harness?
droidrun (a GitHub organization) maintains it in droidrun/mobile-harness, which has 394 GitHub stars. The repository was last updated on October 8, 2026.
Source: droidrun/mobile-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.