README

---


  
  
  
  


---

Enable Claude Code, Codex, or any agent to use your real phone. The agent can
scroll, tap, type, and read your phone with no jailbreak, no Xcode, and nothing
installed on the phone.

 iPhone through the Mac's iPhone Mirroring window 
 Android over adb from macOS, Linux or Windows 
 Phone Harness Cloud phone: an Android over adb, or an iPhone over HTTPS


  ● agent: wants to open Weather
  │
  ● find_text("Weather") → (400, 468)
  │
  ● tap(400, 468) → reads the screen → forecast is up
  ✓ done


Try Phone Harness Cloud → Hosted iPhones and Androids with stealth, real numbers, 2FA, and unlimited devices

Get started by sending the setup prompt to your
coding agent.

 Demo

Task: "Buy me a Waymo to Delah Coffee from my current location."



 Setup

For the CLI, send this setup prompt to your agent (Claude Code, Codex, Grok Bot, and more):

text
Install or upgrade phone-harness to the latest stable version with uv using Python 3.12, register the skill from phone-harness skill, then read https://github.com/phone-harness/phone-harness/blob/main/onboarding.md and walk me through it. Follow https://github.com/phone-harness/phone-harness/blob/main/install.md if setup or connection fails.


The agent installs the CLI, asks which phone to use, and walks you through the steps that need your hands. What each phone needs:

| Phone | Needs |
| --- | --- |
| iPhone | macOS 15+, iPhone Mirroring paired to an iOS 18+ iPhone, Accessibility and Screen Recording permission |
| Android | adb and USB debugging, on macOS, Linux or Windows |
| Cloud Android / iPhone | Phone Harness Cloud account; cloud Android also needs adb |

phone-harness doctor checks the setup. Full details: install.md and setup/.

MCP: add https://mcp.phone-harness.com/mcp to any MCP client (setup). Cloud Android and iPhone only for now.

Hermes Agent: hermes plugins install phone-harness/phone-harness/integrations/hermes. See integrations/hermes.

OpenClaw: openclaw plugins install clawhub:phone-harness. See integrations/openclaw.

 Usage

bash
phone-harness <<'PY'
open_app("Notes")
tap_text("New Note")
type_text("hello from the harness")
print([o["text"] for o in screen()][:10])
PY


Helpers are pre-imported; helpers.py has the full list. The agent saves its own helpers in ~/.phone-harness/agent-workspace.

 Phone Harness Cloud

No phone on your desk, or need more than one? Phone Harness Cloud hosts them for you:

- Android phones on demand: a fresh one per session, or a saved phone that keeps its apps and logins.
- Dedicated real iPhones, driven over HTTPS from any OS.
- A live view of the phone in your browser while the agent works.

bash
phone-harness cloud login             once: approve in your browser
phone-harness cloud ls                phones on the account, and any live session
phone-harness cloud start             cloud.phone if set, else a temporary Android; 15 min (--for 90s, 15m)
phone-harness cloud start ios         the account's iPhone, when only one is l

Top issues

Discussions

Latest release

Highlights
 [NEW] Phone Harness MCP 🔌
 The new phone-harness/mcp connects any MCP client to real iPhones and Androids!


 OpenClaw integration: 
 OpenClaw agents can now drive your iPhone, Android or cloud phone through phone-harness.


 phone-harness GitHub org! 
 The repo moved to phone-harness/phone-harness.


 Other Cool Stuff
- [REALLY COOL!!!] The official phone-harness discord server is now live! I'd love to talk and build with you guys!
- Send files and links to your iPhone: new push_file and open_url helpers put a file on the iPhone or open a URL on it directly.
- Smar