# Mobilerun Docs

Answers Mobilerun setup, SDK, CLI and device questions from its docs.

- Repository: https://github.com/droidrun/mobilerun (9900 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add droidrun/mobilerun --skill mobilerun-docs -g -a claude-code -y`
Codex: `npx skills add droidrun/mobilerun --skill mobilerun-docs -g -a codex -y`
Cursor: `npx skills add droidrun/mobilerun --skill mobilerun-docs -g -a cursor -y`
Gemini CLI: `npx skills add droidrun/mobilerun --skill mobilerun-docs -g -a gemini-cli -y`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/droidrun/mobilerun/blob/HEAD//SKILL.md