Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Proxy through an iPhone while an AI agent controls it

XCTest mode

An agent can control the iPhone with ghosthand while OwnYourProxy proxies through it, if ghosthand uses XCTest mode:
ghosthand control -l <lease> xctest # once per iPhone ownyourproxy run -p 1 -- curl https://api.ipify.org # keeps the mobile IP while the agent taps
XCTest mode needs Xcode on the Mac, and Developer Mode and UI Automation on the iPhone. Setup: ghosthand XCTest mode.

What pauses the proxy

ghosthand modeProxy while the agent controls the iPhone
XCTestWorks. Tested: requests and a long download kept the carrier IP during screenshots, taps and swipes
Bluetooth (default)Pauses. Screenshots use USB screen capture, and that USB mode has no hotspot link
Recording, dashboard previewPause in both modes (USB screen capture)
A paused proxy fails requests instead of using Wi-Fi, and comes back a few seconds after the capture stops. OwnYourProxy shows it as Paused: screen capture. QuickTime screen mirroring pauses it the same way.