whatisgithub

What is mobileagent-android?

gigglewang/mobileagent-android — explained in plain English

Analysis updated 2026-05-18

33KotlinAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

An Android app that lets a vision-capable AI model see your screen and operate your phone to complete tasks you describe.

Mindmap

mindmap
  root((MobileAgent-Android))
    What it does
      Screenshots the screen
      AI plans and acts
      Taps and types for you
    Tech stack
      Kotlin
      Jetpack Compose
      Accessibility API
    Use cases
      Automate phone tasks
      Test AI agent behavior
      Control settings by voice text
    Audience
      Developers
      AI agent researchers
      Android tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give the app a plain-language instruction and let it operate your phone's UI to complete it.

USE CASE 2

Watch the floating status window to see the agent's live progress on a task.

USE CASE 3

Connect it to either an OpenAI-compatible API or Anthropic Claude directly.

USE CASE 4

Study the four-phase Manager, Executor, Reflector, Notetaker loop as a reference agent architecture.

What is it built with?

KotlinJetpack ComposeOkHttpKotlin Coroutines

How does it compare?

gigglewang/mobileagent-androidzenjahid/bkash-synccoldp/todaywallpaper
Stars333130
LanguageKotlinKotlinKotlin
Setup difficultymoderatemoderatemoderate
Complexity4/53/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an Android device running 8.0+, several Accessibility and overlay permissions, and an API key for a vision-capable model.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

MobileAgent Android is an app that lets your Android phone operate itself using an AI vision model. You type a task in plain language, such as "open Settings and turn on Dark Mode," and the app takes a screenshot, sends it to an AI model (such as GPT-4o or Claude), and executes whatever action the model decides on. This cycle repeats until the task is done or a configurable step limit is reached. No PC, USB connection, or ADB tool is required. The app runs a four-phase loop on each step. The Manager phase analyzes the screen and creates a numbered plan of subgoals. The Executor phase selects one concrete action, such as tapping a button, swiping, or typing text. The Reflector phase compares before-and-after screenshots to check whether the action had the intended effect. An optional Notetaker phase extracts useful on-screen information into running notes. If an action fails, the loop tries to replan rather than stopping immediately. Interactive elements on screen are found using Android's Accessibility API, which produces a tree of visible UI components. The app annotates the screenshot with numbered bounding boxes around those elements before sending the image to the AI model, giving the model precise targets to reference when choosing the next action. Setup requires granting several Android permissions: the Accessibility Service for performing taps and typing, an overlay permission for a floating status window that shows live progress, and a battery optimization exemption to prevent the system from stopping the accessibility service mid-task. The app supports OpenAI-compatible API endpoints as well as Anthropic Claude directly, and the interface is available in English and Simplified Chinese. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Explain how the Manager, Executor, Reflector, Notetaker loop in this README coordinates a phone-operating AI agent.
Prompt 2
Walk me through granting the Android permissions this app needs to control the screen.
Prompt 3
Help me configure this app to use Anthropic Claude as the vision-language model.
Prompt 4
How does the Accessibility API let this app find tappable elements on screen, based on this README?

Frequently asked questions

What is mobileagent-android?

An Android app that lets a vision-capable AI model see your screen and operate your phone to complete tasks you describe.

What language is mobileagent-android written in?

Mainly Kotlin. The stack also includes Kotlin, Jetpack Compose, OkHttp.

What license does mobileagent-android use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mobileagent-android to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mobileagent-android for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.