Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
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.
Install Mobilerun Docs Reference
$ npx skills add droidrun/mobilerun --skill mobilerun-docs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install droidrun/mobilerun mobilerun-docs --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 "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .claude/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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/mobilerun --skill mobilerun-docs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install droidrun/mobilerun mobilerun-docs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .agents/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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/mobilerun --skill mobilerun-docs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install droidrun/mobilerun mobilerun-docs --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 "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .cursor/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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/mobilerun --skill mobilerun-docs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install droidrun/mobilerun mobilerun-docs --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 "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .gemini/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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/mobilerun mobilerun-docsInstalls 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/mobilerun --skill mobilerun-docs -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 "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .github/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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/mobilerun --skill mobilerun-docs -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/mobilerun mobilerun-docs --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 "mobilerun-docs" agent skill from https://github.com/droidrun/mobilerun/tree/main into .opencode/skills/mobilerun-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mobilerun-docs", 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
mobilerun-docs- GitHub stars
- 9.6k
- Token cost
- ~943 tokens
- SKILL.md length
- 279 words
- Files
- 312
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
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.
- Answering how to set up or configure Mobilerun
- SKILL.md covers Architecture, Repository Structure and Documentation
- Runs Python scripts from its folder; calls uv
- Looking up Mobilerun CLI commands, SDK usage or device setup
What it does
This is a documentation reference for Mobilerun, an open-source (MIT) framework that controls Android and iOS devices through LLM agents using natural language commands. The SKILL.md summarizes installation (`uv tool install mobilerun`, with Gemini, OpenAI, DeepSeek, Ollama and OpenRouter support included and Anthropic and Langfuse as optional extras) and the requirements: Python 3.11 or later, ADB and the Portal APK on the device.
It describes the architecture: a MobileAgent coordinates either a reasoning mode, where a manager plans and an executor acts in a loop, or a direct mode where a CodeActAgent writes and runs Python. A scripter agent handles off-device computation and a structured-output agent extracts typed data. The atomic device actions are listed (click, long press, type, swipe, open app and more) along with a map of the source tree. For answers, the agent is sent to specific files under `docs/v5/`, which it must read rather than guess.
When your agent uses it
- Answering how to set up or configure Mobilerun
- Looking up Mobilerun CLI commands, SDK usage or device setup
- Understanding the agent architecture, app cards, credentials or tracing
- Using structured output or migrating in Mobilerun
Example prompts
- “How do I install Mobilerun and connect an Android phone over ADB?”
- “What is the difference between Mobilerun's reasoning and direct modes?”
- “Show me how to get typed data out of a Mobilerun run with the structured output agent.”
Requirements
- Python 3.11 or later
- ADB
- The Portal APK installed on the device
What it can do on your machine
Read from SKILL.md and the folder at commit 1935ada. 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
Ships script files (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
docs.mobilerun.ai
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
Mobilerun Docs Reference loads about 943 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 279 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/mobilerun at commit 1935ada, republished under its MIT licence (© droidrun). 279 words, ~943 tokens.
Download SKILL.mdSave it as
.claude/skills/mobilerun-docs/SKILL.md (or your agent's skills folder). This skill also uses 311 other files; get the full folder from GitHub.- name
- mobilerun-docs
- description
- Mobilerun documentation reference. Use when users ask about Mobilerun setup, configuration, SDK usage, CLI commands, device setup, agents, architecture, app cards, credentials, tracing, Docker, migration, structured output, or any Mobilerun "how do I..." questions.
Mobilerun
Mobilerun is an open-source (MIT) framework for controlling Android and iOS devices through LLM agents. It enables mobile automation using natural language commands.
- GitHub: https://github.com/droidrun/mobilerun
- Docs site: https://docs.mobilerun.ai
- License: MIT
- Install:
uv tool install mobilerun(Google Gemini, OpenAI, DeepSeek, Ollama, OpenRouter included by default) - Optional extras:
anthropic,langfuse - Requires: Python 3.11+, ADB, Portal APK on device
Architecture
Mobilerun uses a multi-agent architecture coordinated by MobileAgent:
- Reasoning mode (
reasoning=True): Manager plans → Executor acts → loop until done - Direct mode (
reasoning=False): CodeActAgent generates and executes Python code directly
Key agents: ManagerAgent (planning), ExecutorAgent (actions), CodeActAgent (direct execution), ScripterAgent (off-device computation), StructuredOutputAgent (typed data extraction).
Atomic actions available to agents: click, long_press, type, system_button, swipe,
open_app, get_state, take_screenshot, complete.
Repository Structure
Source code is at mobilerun/ (Python package). Key locations:
| Path | Description |
|---|---|
mobilerun/agent/droid/ | MobileAgent orchestrator |
mobilerun/agent/codeact/ | CodeActAgent (direct mode) |
mobilerun/agent/scripter/ | ScripterAgent (off-device scripts) |
mobilerun/agent/oneflows/ | StructuredOutputAgent |
mobilerun/agent/utils/ | Tools, executor, tracing, async utils |
mobilerun/tools/ | Device tools (ADB, iOS, portal client) |
mobilerun/cli/ | CLI entry point (click-based) |
mobilerun/config/prompts/ | Jinja2 prompt templates per agent |
mobilerun/config/app_cards/ | App-specific instruction cards |
mobilerun/credential_manager/ | YAML-based credential storage |
mobilerun/telemetry/ | Phoenix tracing integration |
Documentation
Read the relevant file(s) from docs/v5/ based on the user's question. Do not guess — always
read the doc before answering.
| Topic | File |
|---|---|
| Overview | docs/v5/overview.mdx |
| Quickstart | docs/v5/quickstart.mdx |
| Concepts | |
| Architecture & agents | docs/v5/concepts/architecture.mdx |
| Events & workflows | docs/v5/concepts/events-and-workflows.mdx |
| Prompts | docs/v5/concepts/prompts.mdx |
| Scripter agent | docs/v5/concepts/scripter-agent.mdx |
| Shared state | docs/v5/concepts/shared-state.mdx |
| Features | |
| App cards | docs/v5/features/app-cards.mdx |
| Credentials | docs/v5/features/credentials.mdx |
| Custom tools | docs/v5/features/custom-tools.mdx |
| Custom variables | docs/v5/features/custom-variables.mdx |
| Structured output | docs/v5/features/structured-output.mdx |
| Telemetry | docs/v5/features/telemetry.mdx |
| Tracing | docs/v5/features/tracing.mdx |
| Guides | |
| CLI usage | docs/v5/guides/cli.mdx |
| Device setup | docs/v5/guides/device-setup.mdx |
| Docker | docs/v5/guides/docker.mdx |
| Migration v3→v4 | docs/v5/guides/migration-v3-to-v4.mdx |
| SDK | |
| MobileAgent | docs/v5/sdk/droid-agent.mdx |
| ADB tools | docs/v5/sdk/adb-tools.mdx |
| iOS tools | docs/v5/sdk/ios-tools.mdx |
| Base tools | docs/v5/sdk/base-tools.mdx |
| Configuration | docs/v5/sdk/configuration.mdx |
| API reference | docs/v5/sdk/reference.mdx |
For deeper implementation details, check the source code directly in mobilerun/.
© 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 311 other files in the repository root of droidrun/mobilerun.
- SKILL.md
- .dockerignore
- .github/workflows/black.yml
- .github/workflows/bounty.yml
- .github/workflows/claude.yml
- .github/workflows/docker.yml
- .github/workflows/publish.yml
- .gitignore
- .python-version
- CONTRIBUTING.md
- Dockerfile
- LICENSE
- MANIFEST.in
- README.md
- agent-test-flows/README.md
- compat/droidrun/__init__.py
- … and 296 more
Open the folder on GitHubat commit 1935ada
Compare with similar skills
Mobilerun Docs Reference 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 |
|---|---|---|---|---|---|---|
| Mobilerun Docs Reference this skilldroidrun/mobilerun | 9.6k | — | ~943 | Automated safety check: Pass | MIT | |
| Phoneagentrounak/PhoneAgent | 798 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Frb Dev Envfzyzcjy/flutter_rust_bridge | 5.4k | — | ~5.5k | Automated safety check: Pass | MIT | |
| Appium Skillsickn33/agentic-awesome-skills | 47k | 1 repos | ~2.8k | Automated safety check: Pass | MIT | |
| Re Mobile Forensicsdslsdzc/rev-skills | 117 | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Appiumblokadaorg/blokada | 3.3k | — | ~3.5k | Automated safety check: Pass | MPL-2.0 |
Similar skills
Frb Dev Env
fzyzcjy/flutter_rust_bridge
A skill your agent uses when the user wants Docker-based FRB development or Tart-based iOS Simulator validation.
Appium Skill
sickn33/agentic-awesome-skills
Generates production-grade Appium mobile automation scripts for Android and iOS in Java, Python, or JavaScript.
Re Mobile Forensics
dslsdzc/rev-skills
移动设备取证：Android/iOS 备份解析、应用数据提取、删除恢复与时间线. An agent skill from dslsdzc/rev-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.
Simvyn
pranshuchittora/simvyn
Operate iOS Simulators, Android Emulators, and connected mobile devices with Simvyn.
Related
Categories
Questions about Mobilerun Docs Reference
What does Mobilerun Docs Reference do?
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. This is a documentation reference for Mobilerun, an open-source (MIT) framework that controls Android and iOS devices through LLM agents using natural language commands.11 or later, ADB and the Portal APK on the device.
When should I use Mobilerun Docs Reference?
Mobilerun Docs Reference fits situations like: answering how to set up or configure Mobilerun; looking up Mobilerun CLI commands, SDK usage or device setup; understanding the agent architecture, app cards, credentials or tracing; using structured output or migrating in Mobilerun.
How do I install Mobilerun Docs Reference in Claude Code?
Run `npx skills add droidrun/mobilerun --skill mobilerun-docs -a claude-code`. Or copy the skill folder (the droidrun/mobilerun repository) into .claude/skills/mobilerun-docs in your project. Claude Code loads it when a task matches its description.
How do I install Mobilerun Docs Reference in Codex?
Run `npx skills add droidrun/mobilerun --skill mobilerun-docs -a codex`. Or copy the skill folder (the droidrun/mobilerun repository) into .agents/skills/mobilerun-docs in your project. Codex loads it when a task matches its description.
Can I use Mobilerun Docs Reference 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/mobilerun --skill mobilerun-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mobilerun-docs, .gemini/skills/mobilerun-docs, .github/skills/mobilerun-docs and .opencode/skills/mobilerun-docs in your project.
What does Mobilerun Docs Reference need to run?
Going by SKILL.md and its folder, Mobilerun Docs Reference needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.11 or later; ADB; The Portal APK installed on the device.
Does Mobilerun Docs Reference access the network?
SKILL.md names 1 domain. As links in the text: docs.mobilerun.ai. This is read from the text; nothing was executed.
Is Mobilerun Docs Reference 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 Mobilerun Docs Reference use?
Mobilerun Docs Reference 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 Mobilerun Docs Reference use?
About 943 tokens (SKILL.md is roughly 3.8k 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 Mobilerun Docs Reference?
Skills that share tags, products or a category with Mobilerun Docs Reference: Phoneagent (rounak/PhoneAgent, 798 stars), Frb Dev Env (fzyzcjy/flutter_rust_bridge, 5.4k stars), Appium Skill (sickn33/agentic-awesome-skills, 47k stars) and Re Mobile Forensics (dslsdzc/rev-skills, 117 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Mobilerun Docs Reference?
droidrun (a GitHub organization) maintains it in droidrun/mobilerun, which has 9,581 GitHub stars. The repository was last updated on October 5, 2026.
Source: droidrun/mobilerun on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.