How do I install the Mobilerun Docs skill?

Run npx skillmds@latest add tomevault-io/mobilerun-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mobilerun Docs safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mobilerun Docs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mobilerun Docs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mobilerun Docs?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mobilerun Docs by tomevault-io — Agent Skill

Name: Mobilerun Docs
Author: tomevault-io

Mobilerun Docs

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. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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/.

Source: droidrun/mobilerun — distributed by TomeVault.

---name: mobilerun-docsdescription: 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. Use when this capability is needed.---# MobilerunMobilerun 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## ArchitectureMobilerun 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 directlyKey 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 StructureSource 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 |## DocumentationRead the relevant file(s) from `docs/v5/` based on the user's question. Do not guess — alwaysread 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/`.---> Source: [droidrun/mobilerun](https://github.com/droidrun/mobilerun) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions