phonelisted

# Drive the user's iPhone (phone-claude) The user's real iPhone is connected to this PC over USB and fully controllable. Harness lives at `C:\Projects\phone-claude`. Works from any project directory. ## Run ```bash cd C:/Projects/phone-claude && ./phone-harness.cmd <<'PY' send_message("Mom", "hi") PY ``` Bare `phone-harness` is NOT on the bash PATH — always use `./phone-harness.cmd` from the repo root. Helpers are pre-imported; print() output comes back to you. **REQUIRED SUB-SKILL:** read `phone-gotchas` before your first tap. It holds the coordinate traps, the batching tool, and what the harness genuinely cannot do — none of which you can learn by looking at the screen. ## Helpers | Helper | Use | |---|---| | `send_message(contact, text)` | full Messages send; `contact` = conversation name in the Messages list | | `read_messages(contact, limit=20)` | read a thread back: `[{text, from_me}, ...]`, oldest first | | `ocr()` | all visible text with center coords (real UI tree, exact). Elements are `{"text","x","y","type","rect"}` — the key is **`text`**, and `full=` is MCP-only | | `find_text(t)` / `tap_text(t)` | locate / tap by visible text | | `wait_for_text(t, timeout=10)` | poll until text appears; returns the element (with x/y) | | `tap(x, y)` / `swipe(x1,y1,x2,y2,secs)` / `scroll("down")` | raw gestures, units = points | | `long_press(x, y, seconds=1.0)` | context menus and other hidden affordances | | `act([{"tool":n,"args":{...}}, ...])` | several tools in ONE ro