What Is Phone Harness?
Phone Harness is a command-line "harness" that lets an AI agent use a phone the way a person does: it taps, types, scrolls and reads the screen, with no jailbreak, no Xcode and nothing installed on the phone, per the README. It is published by Phone Harness Inc., and its homepage says the company is backed by Y Combinator. The repository was first published under the GitHub user ShawnPana and now sits in the phone-harness organization.
The agent pipes short Python scripts into the phone-harness command, using helpers such as opening an app, tapping text, typing text and reading the screen. On an iPhone it captures the iPhone Mirroring window on a Mac, reads it with Apple Vision OCR and sends input as events; on Android it uses adb for screenshots and input and the accessibility tree for text, over USB or Wi-Fi. The same helpers drive a hosted cloud phone, so a script written for one phone runs on the others.
Get It
Phone Harness installs from the terminal with one command: uv tool install --python 3.12 --upgrade --force phone-harness. The maker's recommended route is to send its setup prompt to your coding agent, which installs the CLI, asks which phone to use and walks you through the steps that need your hands.
Channel | Link |
|---|---|
| Website | phone-harness.com |
| Documentation | phone-harness.com/docs |
| Privacy policy | phone-harness.com/privacy |
| Source code (MIT) | github.com/phone-harness/phone-harness |
| PyPI package | pypi.org/project/phone-harness |
| Cloud phones | Phone Harness Cloud |
Version reviewed: 0.3.3, uploaded to PyPI and released on GitHub on 2 November 2026; the latest upstream update at the time of checking was a code push on 3 November 2026. A terminal and a developer setup (uv, Python 3.12) are required: there is no installer, App Store or Google Play listing, and the GitHub releases carry no downloadable files.
What You Need
What the phone needs depends on which mode you pick; the README and install guide list four.
Phone | Needs |
|---|---|
| Your iPhone | macOS 15+, iPhone Mirroring, iOS 18+ phone |
| Your Android | adb and USB debugging; macOS, Linux or Windows |
| Cloud Android | Account, adb, outbound TCP to the phone |
| Cloud iPhone | Account; driven over HTTPS from any OS |
For an iPhone on your own Mac, Accessibility and Screen Recording permission are also required, and the package itself accepts Python 3.10 or newer. A built-in doctor command checks the setup.
Pricing
The command-line tool is free under the MIT license; Phone Harness Cloud is the paid part, with Android billed by the minute or by subscription and iPhones on a flat monthly subscription. The site is marked "Open beta" for the cloud service.
Plan | Price (USD) |
|---|---|
| Basic (cloud Android) | $0/mo + 5¢ per phone-minute |
| Plus (cloud Android) | $20/mo incl. 1,000 min, then 4¢/min |
| Cloud iPhone | $80/mo, or $64/mo billed annually |
| Cloud iPhone with eSIM | $100/mo, or $80/mo billed annually |
| Scale (dedicated phones) | Contact the maker |
Read from phone-harness.com on 8 November 2026. The site lists prices in US dollars only; they are set by the maker and can change. New accounts start with $5 of credit, per the homepage.
Features Confirmed by the Sources
Every item below comes from the maker's site or the repository README.
- One set of helpers for every phone. A script written for an iPhone, an Android or a cloud phone runs on the others, and a default phone is chosen with a config setting.
- Agent integrations. The setup prompt targets Claude Code and Codex; a hosted MCP endpoint serves any MCP client (cloud phones only for now), and plugins exist for Hermes Agent and OpenClaw.
- Self-extending helpers. The agent saves helpers it writes to a workspace folder in your home directory that upgrades do not wipe.
- Cloud phones. Temporary Android phones, saved Android phones that keep apps and logins, and dedicated real iPhones, with a live view in the browser while the agent works.
- Cloud extras the site advertises. Real phone numbers for SMS and two-factor codes, persistent logins and "stealth" so apps see a person; PromptQuorum has not checked these, and automating other apps can conflict with their terms of service.
Privacy and Data Handling
The privacy policy (last updated 3 November 2026) covers phone-harness.com and Phone Harness Cloud, and says that when you or your agent use a cloud phone it automatically logs the activity: commands and their inputs, text entered, taps, apps and pages used, and session details. The stated purposes are running, securing and improving the service and preventing abuse. It also collects your name and email from sign-in, billing records and session logs; card details go to Stripe.
The policy names Clerk (sign-in), Stripe (payments), Amazon Web Services (hosting in the United States), Vercel, PostHog (analytics, only with consent) and Loops (email) as the services it uses. Temporary Android phones are wiped when the session ends; saved Android phones and cloud iPhones keep apps, logins and files until you reset them, and a cloud iPhone is erased within 7 days after the subscription ends. The README adds that the CLI prints a one-line notice when a new version exists, which an environment variable switches off.
📌Note: These are the maker's statements. PromptQuorum has not audited the service or the CLI's network traffic, and the policy describes the website and cloud service, not a phone you connect yourself.
Who Should Use It
- Developers who already run a coding agent and want it to operate a real phone.
- Mac owners who want iPhone control that, per the README, needs no jailbreak or app on the phone.
- Teams who need many phones and are fine with a hosted, paid cloud.
Limits and What We Could Not Verify
- Limits the README lists. Unlocking an iPhone pauses mirroring, a PIN-locked Android needs you, OCR sees text but not icons, there is no multi-touch, camera or Face ID support, DRM video renders black and connecting the phone is always your job.
- Hands-on reliability. PromptQuorum did not run Phone Harness, and the sources publish no benchmark or success-rate figures.
- Local models. The sources name Claude Code, Codex and "any agent" but do not say whether a local model, for example through Ollama, can drive it.
- Cloud claims. Stealth, real phone numbers, Y Combinator backing and the open-beta service were read from the maker's own pages only.
Competitors and Alternatives
PhoneClaw
- Platforms:
- macOS
- Price / license:
- Free / Apache-2.0
- Key difference:
- macOS app that lets an AI agent control and automate your phone
Articles about PhoneClaw (2)
- PhoneClaw Review: The On-Device iPhone AI AgentUpdated September 12, 2026
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous AgentsUpdated November 20, 2026
Open Interpreter
- Platforms:
- macOS, Windows, Linux
- Price / license:
- Free / Apache-2.0
- Key difference:
- Lets a local LLM control your computer and execute code, not a phone
Articles about Open Interpreter (3)
- Open Interpreter Review: Same Name, Rust Core, New LicenseUpdated September 3, 2026
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous AgentsUpdated November 20, 2026
- Nanobot Review: A Self-Hosted AI Agent FrameworkUpdated October 30, 2026
Also mentioned in:
- Goose Review: Block's Open-Source AI Agent, Now Under the Linux FoundationUpdated October 30, 2026
- Kruvo Review: A Desktop AI Coworker That Asks Before It ActsUpdated October 24, 2026
- Multica Review: A Workspace for AI Coding AgentsUpdated September 14, 2026
- Atomic Agent Review: Local AI Agent CLI, Free & MIT-LicensedUpdated September 12, 2026
- PhoneClaw Review: The On-Device iPhone AI AgentUpdated September 12, 2026
Local Operator
- Platforms:
- macOS, Windows, Linux
- Price / license:
- Free / MIT
- Key difference:
- Desktop agent that writes and runs code on your computer, with a local or hosted model
Articles about Local Operator (2)
- Local Operator Review: Free Desktop AI Agent for Your ComputerUpdated October 24, 2026
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous AgentsUpdated November 20, 2026
Competitor details change often; confirm each app's current price, license and platforms on its own listing.
Frequently Asked Questions
Do I need to jailbreak the iPhone or install an app on it?
No, per the README. An iPhone is driven through the iPhone Mirroring window on a Mac, so nothing is installed on the phone.
How do I update Phone Harness?
Run its update command. The CLI also prints one line when a newer version exists; setting PHONE_HARNESS_NO_UPDATE_CHECK=1 silences that notice.
Where do the helpers my agent writes end up?
In ~/.phone-harness/agent-workspace, outside the install, so an upgrade keeps them; an existing workspace is left untouched.
Why does the repository link redirect?
It was first published as ShawnPana/phone-harness and now lives at phone-harness/phone-harness; the old address redirects.
How long does a cloud session last?
The README says the start command runs a session for 15 minutes by default, adjustable with a duration flag, and the stop command ends it, writing a saved Android back.
Verdict
Phone Harness is a free, MIT-licensed tool that, per its maker, gives a coding agent real taps, typing and screen reading on an iPhone or Android phone, with no jailbreak and nothing installed on the phone, plus paid hosted phones. It was updated days before this check and has a published privacy policy. Against that, the project is under three months old at version 0.3.3, iPhone control needs a Mac, OCR misses unlabeled icons, the cloud service logs phone activity by its own account and every behavior claim comes from the maker. It suits developers who already drive a coding agent and want phone access; readers who want a different approach can compare PhoneClaw or Open Interpreter.
Sources
- Phone Harness — maker homepage: description, cloud plans and prices, checked 8 November 2026.
- Phone Harness privacy policy and documentation — data handling, processors and phone retention.
- phone-harness on GitHub — README, install guide, MIT license, release and push dates.
- phone-harness on PyPI — version 0.3.3 and upload date.
