Skip to content
ReviewRamble

The weekly brief

AI, reviewed, in your inbox.

  • New reviews of tools, models, MCP servers and repos, with the verdict up front
  • Re-checked prices and ratings when something changes
  • New analysis pieces as they are published

Models, agents, MCP servers and the tools actually worth your time.

One email a week. Unsubscribe with the link in any brief. How we use your email

phone-harness

A Python CLI and agent skill that lets Claude Code or Codex tap, type and read a real iPhone, an Android or a rented cloud phone.

Reviewed by ReviewRamble editors · Updated

View on GitHub Open source

Share this page:XLinkedInFacebookRedditWhatsAppEmail

Our rating

3.4/5

phone-harness gets an agent onto your own iPhone with less fuss than anything else we have reviewed, but it sends your scripts and screen text to analytics by default, so switch telemetry off before you point it at a personal phone.

What is phone-harness?

phone-harness lets a coding agent use a phone the way a person does. The agent writes short Python scripts against pre-imported helpers such as open_app, tap_text, type_text and screen, and the CLI runs them. An iPhone is driven through the iPhone Mirroring window on a Mac, read with Apple's Vision OCR and controlled with synthetic input events; an Android is driven over adb, with text from its accessibility tree. Nothing is installed on the phone and no jailbreak is needed.

The same helpers drive phones from Phone Harness Cloud, the company's paid service: Android emulators over adb and dedicated real iPhones over HTTPS, with a live view in the browser. A hosted MCP server covers cloud phones only, and there are plugins for Hermes Agent and OpenClaw. The agent can save its own helper functions in a workspace folder that survives upgrades.

The CLI is MIT-licensed and the company says it is backed by Y Combinator. The repository was created in August 2026; version 0.3.3 shipped on 2 November 2026.

Is phone-harness worth it?

phone-harness solves a narrow problem well: most phone tools for agents need Xcode, a test build or an app on the device, and this one drives the iPhone already in your pocket through macOS iPhone Mirroring. The cost of that shortcut is reading the screen with OCR. It sees text, not icons, so unlabelled buttons need a screenshot and a vision model, and there is no multi-touch, camera or Face ID. Android is on firmer ground, with adb input and the accessibility tree.

Be clear about the access it needs. On a Mac, the terminal or agent app that runs it must hold Accessibility and Screen Recording permission, which lets that app read the whole screen and send keystrokes to any window, not only the phone. On Android, USB or wireless debugging gives the computer full control of the device. The agent then runs Python it writes itself, with no approval step for a purchase or a message; the README's own demo has an agent book a Waymo ride. pinky, by contrast, holds risky taps until you approve them.

The telemetry is the part to act on. Unless DO_NOT_TRACK=1 or phone-harness config set telemetry false is set, each CLI call sends an event to PostHog carrying the script (up to 20,000 characters) and the last 20,000 characters of its output, which is often text read off your phone's screen. Once you sign in to the cloud, those events are linked to your account. The install guide mentions the switch in one paragraph; the README does not.

The code is small, about 8,600 lines of Python from five contributors, against 5,328 stars, and the repository doubles as the front door for a paid cloud that the README promotes throughout. The cloud prices are clear: Android emulators at 5¢ a minute or 1,000 minutes for $20 a month, and real iPhones from $80 a month on a flat rate, reserved with a $20 deposit. For app testing, agent-device is the more complete tool; phone-harness is for driving your own phone.

Where it earns its place

  • A Mac-based developer with an iPhone on iOS 18

    Have Claude Code check an app's status screen on the phone each morning

    Install with uv, register the skill, pair iPhone Mirroring and grant the terminal Accessibility and Screen Recording, set telemetry off, then let the agent run a short script with open_app and screen. Free on your own hardware.

  • A QA engineer at a five-person startup with no device lab

    Run an agent through an Android signup flow on a clean phone

    phone-harness cloud start gives a fresh Android emulator for 15 minutes by default; the agent drives it over adb and you watch the live view. At 5¢ a minute, a 15-minute run costs 75¢ from the $5 starting credit.

  • A growth team that needs a real iPhone with its own phone number

    Let an agent complete app flows that need SMS codes

    Reserve a cloud iPhone with eSIM using the cloud reserve command and a $20 refundable deposit; it then bills a flat $100 a month at list price, driven over HTTPS from any OS.

Before you commit

Setup
uv tool install phone-harness with Python 3.12, then register the output of phone-harness skill with your agent. iPhone needs macOS 15+, paired iPhone Mirroring on iOS 18+ and two macOS permissions; Android needs adb and USB or wireless debugging. phone-harness doctor names the first missing step.
Integrations
Agent skill for Claude Code, Codex and others; a hosted MCP server at mcp.phone-harness.com for cloud phones only; plugins for Hermes Agent and OpenClaw; an HTTP API for cloud phones.
Data and privacy
Local control stays on your machine, but opt-out PostHog telemetry sends each script and up to 20,000 characters of output, linked to your cloud account once signed in; off with DO_NOT_TRACK=1. Off by default under Hermes. A saved cloud Android keeps its apps and logins on the provider's side.
Cost at scale
Local use is free. Cloud Android Basic is 5¢ a phone-minute; Plus is $20/month with 1,000 minutes, then 4¢. A real iPhone is $80/month list ($100 with eSIM), $64 a month billed annually; larger fleets are quoted on contact.
Cancelling and refunds
Cloud reservations can be cancelled from the CLI and the deposit returns to the paying card until a phone is handed over; after that the deposit comes off the first bill and is not refundable. Refund terms for subscriptions are on a separate refunds page we did not verify.
Limits
Unlocking the iPhone pauses mirroring; a PIN-locked Android needs you; DRM video renders black; five unpaid reservations an hour per account; the MCP server does not reach local phones.

What’s good

  • Drives a personal iPhone with no Xcode, jailbreak or on-phone app
  • Same helpers across iPhone, Android and cloud phones
  • Agent keeps its own helper library between upgrades
  • Clear per-minute and flat cloud pricing

What’s not

  • Opt-out telemetry sends scripts and screen text to PostHog
  • Mac permissions give the agent's app control of the whole screen
  • OCR sees text only; no icons, multi-touch or Face ID
  • No approval step before purchases or messages

Best for

Developers who want an agent to run errands or checks on their own iPhone or Android, or on a rented cloud phone, and who will turn telemetry off first.

phone-harness alternatives

phone-harness: common questions

Is phone-harness worth it?
phone-harness gets an agent onto your own iPhone with less fuss than anything else we have reviewed, but it sends your scripts and screen text to analytics by default, so switch telemetry off before you point it at a personal phone. We rate it 3.4 out of 5.
How much does phone-harness cost?
CLI free under MIT. Cloud: Android at 5¢ a phone-minute with $5 starting credit, or Plus at $20/month for 1,000 minutes; real iPhones from $80/month ($50 for a first phone at the time of writing).
What are the downsides of phone-harness?
Opt-out telemetry sends scripts and screen text to PostHog; mac permissions give the agent's app control of the whole screen; oCR sees text only; no icons, multi-touch or Face ID; no approval step before purchases or messages.
Who is phone-harness best for?
Developers who want an agent to run errands or checks on their own iPhone or Android, or on a rented cloud phone, and who will turn telemetry off first.
How much does phone-harness cost for a team or in production?
Local use is free. Cloud Android Basic is 5¢ a phone-minute; Plus is $20/month with 1,000 minutes, then 4¢. A real iPhone is $80/month list ($100 with eSIM), $64 a month billed annually; larger fleets are quoted on contact.
Is phone-harness safe for company data?
Local control stays on your machine, but opt-out PostHog telemetry sends each script and up to 20,000 characters of output, linked to your cloud account once signed in; off with DO_NOT_TRACK=1. Off by default under Hermes. A saved cloud Android keeps its apps and logins on the provider's side.
How do I cancel phone-harness, and can I get a refund?
Cloud reservations can be cancelled from the CLI and the deposit returns to the paying card until a phone is handed over; after that the deposit comes off the first bill and is not refundable. Refund terms for subscriptions are on a separate refunds page we did not verify.
What are the best phone-harness alternatives?
The closest alternatives we have reviewed are agent-device, Pinky and Droidline.

Answers checked Nov 20, 2026.