Tools/ShawnPana/phone-harness

phone-harness

let your agent control your phone

1.7kemergingPythonMIT Licensenew this week

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Aug 2026

Phone-harness lets an AI agent physically drive your iPhone. It captures the macOS iPhone Mirroring window, runs Apple's OCR over it for eyes, and posts real taps, drags, and keystrokes for hands. No jailbreak, no Xcode, about 500 lines of Python, MIT licensed and free.

Setup is a one-time iPhone Mirroring pairing plus Accessibility and Screen Recording permissions, and a doctor command checks the chain. The design constraint is that the mirroring window is just a video stream: no accessibility tree, so anything not rendered as readable text is invisible to the agent, and the window must stay frontmost, so your Mac is occupied while it runs.

This is a proof of concept for people experimenting with agent-driven mobile automation, not a QA tool; Appium and Maestro remain the serious answers for testing. And it does not work in the EU at all, because Apple has never shipped iPhone Mirroring there.

The catch: you're giving an LLM unsupervised control of your personal, logged-in phone with nothing sandboxing it. Very young, tiny commit history, and the issue list is already outrunning the code. Fun to try; think hard before trusting it.

Free vs Self-Hosted vs Paid

fully free

Free: Everything. MIT, no commercial offering.

Requirements that gate it: macOS Sequoia or later, an iPhone paired via iPhone Mirroring, Accessibility and Screen Recording permissions. Unavailable in the EU because iPhone Mirroring has never shipped there.

The trade: Free phone automation in exchange for handing an LLM live control of your logged-in device.

Completely free and open source. The cost is trust: an LLM gets unsandboxed control of your real phone.

Self-hosting ops:moderate

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
68/100 · B
Adoption13/30
Maintenance25/25
Community5/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

License: MIT License

Use freely, including commercial. Just keep the license.

Commercial use: ✓ Yes

About

Owner
shawn pana (User)
Stars
1,661
Forks
145

Explore Further

More tools in the directory