GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Se ejecuta en la nube✓ del servicio · gitdiagram.comProbado por el equipo de PopNx
Ghost in the Droid
What it does
Give any AI agent a real Android phone or iPhone. 66 MCP tools, 117 hub skills, human in the loop.
- Connects Se ejecuta en tu computadora
- Account or key No key needed
- Category Herramientas para desarrolladores
Instalación
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 15 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Ghost in the Droid para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "android-agent": { "command": "uvx", "args": [ "ghost-in-the-droid" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Ghost in the Droid aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "android-agent": { "command": "uvx", "args": [ "ghost-in-the-droid" ] } } }Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Ghost in the Droid y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Ghost in the Droid o muestra una herramienta de Ghost in the Droid en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Ghost in the Droid
Ghost in the Droid se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Ghost in the Droid
- Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Instala Python (uv) en tu computadora primero (una sola vez)
- Instala Python (uv) en tu computadora primero (una sola vez)
- Instala Python (uv) en tu computadora primero (una sola vez)
B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Ghost in the Droid para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user android-agent -- uvx ghost-in-the-droid 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Ghost in the Droid aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user android-agent -- uvx ghost-in-the-droidEscribe /mcp en Claude Code
Deberías ver Ghost in the Droid en la lista como conectado
Pruébalo
Usa Ghost in the Droid y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Ghost in the Droid o muestra una herramienta de Ghost in the Droid en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Ghost in the Droid para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "android-agent": { "command": "uvx", "args": [ "ghost-in-the-droid" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Ghost in the Droid aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Ghost in the Droid y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Ghost in the Droid o muestra una herramienta de Ghost in the Droid en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Ghost in the Droid para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "android-agent": { "type": "stdio", "command": "uvx", "args": [ "ghost-in-the-droid" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Ghost in the Droid aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
uv --versionSe instala una vez y sirve para todo lo que usa uv
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Ghost in the Droid y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Ghost in the Droid o muestra una herramienta de Ghost in the Droid en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user android-agent -- uvx ghost-in-the-droidClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"android-agent": {
"command": "uvx",
"args": [
"ghost-in-the-droid"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"android-agent": {
"command": "uvx",
"args": [
"ghost-in-the-droid"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"android-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"ghost-in-the-droid"
]
}
}
}Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
- Descargas por semanai
- 102/sem
- Conexión
- Se ejecuta en tu computadora
- Última versióni
- 1.6.0
- Categoríai
- Herramientas para desarrolladores
- Publicado en el registroi
- 15 nov 2026
- Último cambio de códigoi
- 15 nov 2026
- Creador
- ghost-in-the-droid
- Paquetes
pypi: ghost-in-the-droid- Sitio web
- ghostinthedroid.com
- Estado en el registro
- Activo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub ghost-in-the-droid, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hoy
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Sin entradas en OSV.dev para ghost-in-the-droid@1.6.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Creadores: pedir otra revisión o avisar de un dato erróneo
Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Herramientas para desarrolladoresi
- Más estrellas que el 98% de los otros 5916 servidores de esta categoría
- Publicado en el registro más recientemente que el 98% de los otros 5916 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 5916 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Ghost in the Droid?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hoy, y la última versión (1.6.0) llegó al registro hoy.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Se ejecuta en la nube✓ del servicio · appllama.io
Cloudflare MCP
Cloudflare MCP servers
Se ejecuta en la nube✓ del servicio · mcp.cloudflare.comProbado por el equipo de PopNx
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Se ejecuta en la nube✓ del servicio · omnara.com
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
Computadora o nube✓ del servicio · repowise.dev
- GitDiagram — Funciona en la nube, sin instalar nada · Sin clave
- Appllama — Funciona en la nube, sin instalar nada · Sin clave
- Cloudflare MCP — Funciona en la nube, sin instalar nada · Sin clave · En el directorio de Claude
- Omnara — Funciona en la nube, sin instalar nada · Sin clave
- Repowise — En la nube o instalado en tu equipo · Sin clave
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Ghost in the Droid
Summon a ghost into your phone.
It sees the screen. It taps the buttons. It never sleeps.
Website · Docs · Skill Hub · Releases
▶ 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
- iOS control through WebDriverAgent: screenshot, accessibility tree, tap, swipe, type, app launch, clipboard, browser actions
- Live phone screen streaming: Android MJPEG/WebRTC, iOS WDA MJPEG with screenshot fallback
- Interactive touch-to-tap on the streamed screen
- Multi-device phone farm with per-device job queues
Forge reusable skills for any app
- YAML-based UI element definitions per app
- Platform-specific selectors with
elements.yamlfor Android andelements_ios.yamlfor iOS - Python action classes with precondition checks
- Multi-step workflows that chain actions together
- Built-in skills for TikTok and Play Store
- iOS browser/news demo skill and smoke-level TikTok iOS workflows
- Skill Hub: browse, search, and install skills from the community registry
- Install from CLI:
android-agent skill install tiktok
Teach the ghost new tricks
- BFS-based auto app explorer: discovers every screen and transition
- LLM-assisted Skill Creator: chat with AI while viewing the live device stream
- The AI identifies UI elements and generates action/workflow code
Scale the haunting
- Multi-device phone farm with per-device job queues
- Bot runner: queue, schedule, and monitor automation jobs
- Per-device integration tests with Android screen recording or iOS WDA MJPEG recording
Platform Support
| Surface | Android | iOS |
|---|---|---|
| Device ref | ADB serial, e.g. emulator-5554 | ios: |
| Backend | ADB + optional Portal companion app | Appium XCUITest + WebDriverAgent |
| Real device support | Yes | Yes, with Mac/Xcode/WDA signing |
| Simulator/emulator support | Android emulator tooling | Booted iOS simulators via Appium/WDA |
| Live stream | Portal WebRTC, MJPEG, screencap | WDA MJPEG, screenshot polling fallback |
| Screen tree | Android UIAutomator XML | Normalized XCTest accessibility tree |
| Skills | elements.yaml, Android packages | elements_ios.yaml, iOS bundle IDs |
| Android-only today | ADB shell, intents, wireless ADB, Play Store helpers, Portal overlay | Unsupported with stable platform errors |
Why it is built this way
Skills cost $0. Thinking costs tokens. An agent should not pay an LLM to tap a button it has tapped a thousand times. Known workflows compile to skills: deterministic YAML + Python recipes that replay in seconds with zero LLM calls. Use AI for the unknown task, replay for the known one.
The phone is the easiest sandbox there is. Give the ghost an old Android with its own SIM and its own accounts, physically separate from your life. You already know how to set up a phone.
Zero-app by default. A fresh install touches nothing on the Android device: screen reads go through uiautomator, actions through adb shell input, no root, no accessibility service. Want it faster? The optional Portal companion app gives roughly 30x quicker UI reads. Want it private? On-device mode runs the whole loop inside the phone, nothing leaves it. All opt-in.
Local-first, cloud-optional. The server and dashboard run on your machine. With a local or on-device brain, your screenshots never leave your network. Pick a cloud brain and prompts go to that provider, same as any tool. Your call, always.
Requirements
- Python 3.10+
- Android: Android phone with USB debugging enabled and ADB on PATH (
adb devicesshould list your phone) - iOS: macOS with Xcode, Appium 2 + XCUITest driver, and a trusted iPhone or booted simulator
- Node.js 18+ (for the frontend dev server)
iOS Support
Ghost drives iPhones through Appium/WebDriverAgent with the same tool surface: ios: device refs route tap/swipe/type/screenshot to WDA, and iOS-aware browser primitives (open_url, read_news, extract_visible_text) cover web tasks. Android-only tools (shell, launch_intent, Portal overlay) return a clear platform error instead of failing silently.
iOS is opt-in: enable it with GITD_ENABLE_IOS=1 (or ios_platform_enabled=true in .env). Wireless drive rides your Tailscale tailnet, so treat the tailnet as the trust boundary. See docs/SETUP_IOS.md for Appium/WDA setup, and on-device on iPhone to run the model on the iPhone itself.
Quick Start
Zero-install with uvx (or pipx):
uvx ghost-in-the-droid doctor # green/red preflight: python, adb on PATH, devices, ports, LLM keysuvx ghost-in-the-droid login # sign in with your Claude subscription, no API key needed uvx ghost-in-the-droid up # server + dashboard at http://localhost:5055 (API docs at /docs)
doctor prints a checklist with fix hints instead of a stack trace when something is missing (e.g. adb not on PATH). Prefer pipx? pipx install ghost-in-the-droid gives you the `ghost-