Create

Sign in to ReadmeX

or

How we handle your data: Privacy Policy

ReadmeX

Your AI reading companion

What would you like to catch up on?

Pick a briefing, or ask your own question.

Your community and people briefings stay personal to you.

phone-harness

phone-harness: Let your agent use your phone.

What problem it solves

Coding agents need a way to interact with a real phone without requiring device modification or a native development environment. phone-harness gives agents a shared interface for reading screens and performing actions on iPhone, Android, and cloud phones.

Key features

  • Real-device phone control — Agents can scroll, tap, type, and read the screen on a real iPhone or Android without installing software on the phone.

    Source: README

  • One helper interface across phones — The same helpers can drive local and cloud phones, allowing scripts to move between supported platforms without separate interfaces.

    Source: README, src/phone_harness/helpers.py

  • Cloud-hosted iPhone and Android access — Phone Harness Cloud provides temporary or saved Android phones, dedicated iPhones driven over HTTPS, and a browser-based live view.

    Source: README

  • Agent setup and diagnostics — A setup prompt guides the agent through installation and connection, while a doctor command checks the configured setup.

    Source: README, onboarding.md

  • Integration with agent tools — The project documents setup through MCP clients and provides integrations for Hermes Agent and OpenClaw.

    Source: README, integrations

Quick start

Copied verbatim from the project's README.

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 listed
phone-harness <<'PY'
print(screenshot())
PY
phone-harness cloud stop             # ends the session; a saved Android is written back
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

Who it may suit

This may suit developers building coding agents or automation workflows that need to operate iPhone or Android interfaces. It may also suit agent platforms that want to expose supported phone actions through MCP or plugin integrations.

Topics to discuss

  • Which additional phone actions should be included in the shared helper interface?

  • How should agents handle visual controls that OCR cannot identify?

  • Which local, cloud, and MCP setup workflows need clearer onboarding guidance?


Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/phone-harness/phone-harness#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.

github.comhttps://github.com/phone-harness/phone-harness

Comments

…