Phone Harness
Let your coding agent use your real phone — scroll, tap, type and read the screen, with no jailbreak and nothing installed on the phone.
Project intro
Phone Harness lets Claude Code, Codex or any agent use your real phone: scroll, tap, type and read the screen, with no jailbreak, no Xcode and nothing installed on the phone. You describe the job in words and the agent does the tapping.
An iPhone works through the Mac's iPhone Mirroring window, read with Apple's Vision OCR, with taps and typing sent back as input events. An Android works over adb, by USB or Wi-Fi. The demo in the readme is an agent ordering a Waymo ride to a coffee shop on a real iPhone. Setup is one prompt sent to your agent: it installs the command-line tool with uv and Python 3.12, then walks you through the steps that need your hands.
The same helpers drive every phone, so a script written for one runs on the others, and the agent can save its own helpers for later. There is an MCP endpoint and plugins for OpenClaw and Hermes, and a hosted cloud option if you have no phone on your desk — fresh Android phones per session, or dedicated real iPhones driven over HTTPS.
It has 5,107 stars on GitHub with 529 forks, was created in August 2026 and was last pushed on 9 November 2026. It is MIT licensed and free, maintained by one person in their own time. Honest limits: unlocking the iPhone pauses mirroring, OCR reads text but not icons, and there is no multi-touch, no camera or Face ID flow, and DRM video renders black.
Actions
Tech stack
Project info
- Project category
- Developer Tools
- Project status
- Online
- Collaboration intent
- None