ghost-in-the-droid/android-agent

Summon a ghost into your phone.
It sees the screen. It taps the buttons. It never sleeps.
Website ·
Docs ·
Skill Hub ·
Releases
inline; the poster + linked image are the fallback for older markdown renderers. -->
▶ Watch full HD with sound on YouTube · Download mp4
Nine agents. Nine real devices. One ghost. (Click to watch.)
## The pitch, in one breath
Every AI agent can think. Almost none can touch a phone.
Ghost is the body. It gives any LLM agent a real Android phone or iPhone: it reads the screen, taps, swipes, and types through a clean tool surface, and it scales from one device on your desk to a whole phone farm. Point Claude Code, Codex, Antigravity, Cursor, your LangChain app, or a model running inside the phone itself at it, and your agent grows hands.
Bring your own brain. Keep the same body. MIT, forever.
## Mix and match: the Ghost matrix
Ghost 1.3 is the only Android + iOS agent framework where platform, brain, and driver are all swappable. Pick one from each column. They all compose.
| Pick a platform | Pick a brain | Pick a driver |
| Android over USB ADB | Claude Code (free with your Max/Pro sub) | MCP client (Claude Code, Codex, Antigravity, Cursor, Opencode) |
| Android over Wi-Fi ADB | Anthropic API | LangChain toolkit |
| Android in a Docker + KVM emulator pool | OpenRouter (any model, one key) | LlamaIndex tool spec |
| iPhone over Appium + WebDriverAgent | Ollama (fully local) | Ghost CLI (ghost "book a table" --device pixel) |
| iPhone over Tailscale + WebDriverAgent (wireless) | vLLM (your own GPU) | Web dashboard chat with a live phone stream |
| | On-device — llama.cpp (.gguf, any quant), MediaPipe (.task, Gemma mobile bundles), MLX (Apple Silicon, opt-in). The model runs in the phone, airplane-mode works | REST API (/docs OpenAPI) |
The Docker + KVM emulator pool is Android-only; iOS uses Apple's own simulator and Xcode signing, which are macOS-native.
The body stays the same 62 MCP tools no matter what you plug in. Every new model release is a free upgrade to your phone agent.
## See it in action
Nine demos, one per feature, each recorded on real devices. Click any clip for the full mp4.
MCP clients: point your agent at a phone
Claude Code : type in the TUI, watch it drive the phone.
Codex : OpenAI's CLI operating a real phone over MCP.
Antigravity : Google's agent, same 62-tool body.
Interfaces: CLI, framework, browser
Ghost CLI : ghost "check reddit" --device asus .
LangChain : Ghost's tools in a framework agent.
Web chat : chat in your browser, it drives a real phone.
On-device and iOS: the phone as body and brain
On-device Android : model runs in the app, airplane mode.
On-device iPhone : your iPhone talks to itself.
iPhone, real app : Ghost does the Duolingo lesson.
## What It Does
Open-source Python framework for controlling Android and iOS devices from one agent harness. Android runs through ADB. iOS runs through Appium XCUITest and WebDriverAgent, with real iPhones as the target path and simulators for development and CI.
Define skills for any app, run them from the dashboard or API, scale across a phone farm.
The ghost taps what you'd tap
Android control through ADB: tap, swipe, type, clipboard, shell, intents, and stealth variants