Дайте своему агенту кодирования руки на телефоне Android.

** Без ключей API. Нет встроенного LLM. Нет облачного аккаунта. Действующий кодирующий агент решает Что делать: использование телефона обеспечивает небольшой MCP-сервер и JSON CLI для наблюдения и работы Устройство на базе Android Debug Bridge (ADB). Сам агент может иметь собственную подписку. или типовых требований. Использование телефона не добавляет ничего.

Android-first, лицензированный MIT, Python 3.11+. Никаких компаньонов APK, root или телеметрии. Ввод текста в iOS и Unicode не поддерживается в v0.1. Факультативная размещенная реле пересылает телефонные данные через Cloudflare; см. его уведомление о конфиденциальности.

Смотрите демо-версию Android (28 секунд): клиент MCP, управляемый скриншотом, вводит образец текста, нажимает Apply и проверяет результат Производственная ретрансляция HTTPS. непрерывный захват телефона, показанный со скоростью 2x; Это техническое демо, а не запись ChatGPT Developer Mode.

Быстрый старт

Установите Android-платформы, включить отладку USB, подключить разблокированный телефон и принять его разрешение на отладку. Используйте эмулятор, если вы не хотите использовать персональное устройство.

Клонируйте репозиторий, затем установите с uv:

В качестве альтернативы: python -m pip install ., затем phone-use serve.

phone-use

Give your coding agent hands on an Android phone.

No API keys. No embedded LLM. No cloud account. Your existing coding agent decides what to do; phone-use provides a small MCP server and JSON CLI to observe and operate the device over Android Debug Bridge (ADB). The agent itself may have its own subscription or model requirements. phone-use adds none.

Android-first, MIT licensed, Python 3.11+. No companion APK, root, or telemetry. iOS and Unicode text entry are not supported in v0.1. The optional hosted relay forwards phone data through Cloudflare; see its privacy notice.

Watch the real Android demo (28 seconds): a screenshot-guided MCP client types sample text, presses Apply, and checks the result through the production HTTPS relay. Continuous phone capture shown at 2x speed; this is a technical demo, not a recording of ChatGPT Developer Mode.

Quick start

Install Android platform-tools, enable USB debugging, connect an unlocked phone, and accept its debugging authorization. Use an emulator if you do not want to use a personal device.

Clone the repository, then install with uv:

git clone https://github.com/sauravtom/phone-use.git
cd phone-use
uv sync --locked
adb devices -l
uv run --locked phone-use call devices
uv run --locked phone-use call status
uv run --locked phone-use call observe
uv run --locked phone-use serve

Alternatively: python -m pip install ., then phone-use serve. This repository is installable from source; no PyPI release is claimed.

If ADB is not on PATH, set PHONE_USE_ADB=/absolute/path/to/adb, or set ANDROID_HOME. Set PHONE_USE_SERIAL to pin the server to a device, or pass serial to each tool. Auto-selection works only when exactly one device is attached and authorized.

Hosted MCP

Use https://phone-use.xagi.in/mcp in an OAuth-capable MCP client. On the computer connected to your Android device, run:

uv run --locked phone-use connect --serial YOUR_ADB_SERIAL

Start the MCP client’s connection flow, paste the one-time code from the bridge, and approve phone access. Pairing expires after 10 minutes; sessions last at most 8 hours. Stop the bridge to disconnect. This is an outbound connection: do not expose ADB to the internet. Each bridge is restricted to the explicitly selected device.

Codex plugin

Download the phone-use plugin ZIP for the bundled skill and CLI runtime. See plugin setup and submission status. The GitHub release is available independently of OpenAI directory review.

Add to your coding agent

Most MCP clients accept this stdio configuration (replace the path):

{
  "mcpServers": {
    "phone-use": {