Skip to main content
Welcome to the Mobilerun Guides! This section provides step-by-step instructions and best practices for using Mobilerun. Each guide focuses on a specific aspect of the framework, from device setup to advanced automation patterns.

​
Available Guides

​
Getting Started

CLI Reference - Complete command-line interface guide
  • Natural-language runs and LLM setup (run, configure)
  • Cloud authentication (login, whoami, logout)
  • Device setup and control (devices, setup, connect, disconnect, ping, doctor, device)
  • Recorded automation replay (macro)
  • Configuration overrides and flags
  • Environment variables and API keys
  • Common workflows and troubleshooting
Device Setup - Set up Android and iOS devices
  • Install Portal or use Android through ADB
  • Connect devices over USB or Wi-Fi
  • Select and troubleshoot multiple devices
Configuration System - Configure agents, models, devices, and tools
  • Use Python or YAML configuration
  • Select LLM providers and models
  • Customize prompts and app cards

​
Templates

Explore real-world examples and starter projects in the mobilerun-framework-examples repository:
  • LinkedInJobsScraper - Agentic workflow that searches LinkedIn for roles, evaluates matches, and prepares tailored applications
  • LinkedInLeads - End-to-end lead discovery and enrichment for LinkedIn companies and roles
  • TwitterPost - Finds trending topics, drafts posts, and generates images to publish on X/Twitter
  • play2048 - MobileAgent that plays the 2048 game on play2048.co
Each example includes a self-contained workflow with entrypoint, configuration, and sample data. See the README for setup instructions and contribution guidelines.
Need help? Join our Discord community for support and discussions.