OpenParable
Skip to content
← Back to skills

Mobilerun Docs

Apps & Automation
mobilerun-docs

Mobilerun Docs is an Agent Skill for apps & automation published in the droidrun/mobilerun repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/droidrun/mobilerun/blob/HEAD/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/mobilerun-docs, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.

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:

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

TopicFile
Overviewdocs/v5/overview.mdx
Quickstartdocs/v5/quickstart.mdx
Concepts
Architecture & agentsdocs/v5/concepts/architecture.mdx
Events & workflowsdocs/v5/concepts/events-and-workflows.mdx
Promptsdocs/v5/concepts/prompts.mdx
Scripter agentdocs/v5/concepts/scripter-agent.mdx
Shared statedocs/v5/concepts/shared-state.mdx
Features
App cardsdocs/v5/features/app-cards.mdx
Credentialsdocs/v5/features/credentials.mdx
Custom toolsdocs/v5/features/custom-tools.mdx
Custom variablesdocs/v5/features/custom-variables.mdx
Structured outputdocs/v5/features/structured-output.mdx
Telemetrydocs/v5/features/telemetry.mdx
Tracingdocs/v5/features/tracing.mdx
Guides
CLI usagedocs/v5/guides/cli.mdx
Device setupdocs/v5/guides/device-setup.mdx
Dockerdocs/v5/guides/docker.mdx
Migration v3→v4docs/v5/guides/migration-v3-to-v4.mdx
SDK
MobileAgentdocs/v5/sdk/droid-agent.mdx
ADB toolsdocs/v5/sdk/adb-tools.mdx
iOS toolsdocs/v5/sdk/ios-tools.mdx
Base toolsdocs/v5/sdk/base-tools.mdx
Configurationdocs/v5/sdk/configuration.mdx
API referencedocs/v5/sdk/reference.mdx

For deeper implementation details, check the source code directly in mobilerun/.