phone-harness

Phone Harness is a tool that connects coding agents such as Claude Code or Codex to a real phone. It supports iPhone through the Mac's iPhone Mirroring window and Android over adb from macOS, Linux, or Windows. No jailbreak, Xcode, or software installed on the phone is required. The agent can see the screen, find text with tap-ready coordinates, tap, swipe, type, and read the result. A setup prompt lets the agent clone and install the tool, register it as an agent skill, and guide the user through pairing steps. A `--doctor` command checks the connection chain. For iPhone, the harness captures the mirroring window, performs OCR with Apple's Vision framework, and posts HID-level events for taps, swipes, and typing. For Android, it uses adb with `screencap` for capture, the accessibility tree for text, and `input` for actions over USB or Wi-Fi. The same helpers work on both platforms. A cloud option provides hosted Android phones reachable over adb, with persistent apps and logins, and the first 100 minutes free. Documented limits include no multi-touch, no camera or Face ID flows, DRM video rendering black, and the user must handle phone unlocking and connection.