안드로이드 폰에서 코딩 에이전트 손을 제공합니다.

** API 키 없음. 임베디드 LLM 없음. 클라우드 계정 없음.** 기존 코딩 에이전트 결정 무엇을 할; 전화 사용은 작은 MCP 서버와 JSON CLI를 제공하여 관찰하고 작동 Android Debug Bridge (ADB)에 대한 장치. 대리인 자체는 그것의 자신의 구독이 있을지도 모릅니다 또는 모형 필요조건. 전화 사용은 none을 추가합니다.

Android-first, MIT 라이센스, Python 3.11+. 아니 동반자 APK, 루트, 또는 telemetry. iOS 및 Unicode 텍스트 입력은 v0.1에서 지원되지 않습니다. 옵션 호스팅 릴레이 Cloudflare를 통해 전화 데이터를 전달; 그것의 개인 정보 보호 통지를 참조하십시오.

실제 안드로이드 데모 보기 (28 초): 스크린 샷 가이드 MCP 클라이언트 유형 샘플 텍스트, 프레스 적용 및 결과 확인 생산 HTTPS 릴레이를 통해. 연속 전화 캡처 2x 속도; 이것은 ChatGPT 개발자 모드의 녹음이 아닌 기술적 데모입니다.

빠른 시작

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": {