본문으로 건너뛰기
오픈소스 전체 목록

phone-harness

  • 추천0
  • GitHub 별5K
  • 개발라이선스MIT

Claude Code · Codex 같은 에이전트가 진짜 폰(iPhone · Android · 클라우드 폰)을 탭 · 입력 · 화면 읽기로 쓰게 하는 CLI. MIT

원본:phone-harness/phone-harness

요약

Claude Code · Codex 같은 에이전트가 진짜 폰(iPhone · Android · 클라우드 폰)을 탭 · 입력 · 화면 읽기로 쓰게 하는 CLI. MIT

설명

phone-harness

에이전트가 당신의 폰을 쓰게 하세요.


문서 Phone Harness Cloud 나만의 클라우드 Android 폰을 무료로 써 보세요!

Discord LinkedIn GitHub X


Claude Code, Codex 같은 어떤 에이전트든 당신의 실제 폰을 쓰게 하세요. 에이전트는 탈옥도, Xcode도, 폰에 설치할 것도 없이 폰을 스크롤하고, 탭하고, 입력하고, 읽을 수 있습니다.

  • iPhone: Mac의 iPhone Mirroring 창을 통해
  • Android: macOS, Linux, Windows에서 adb로
  • Phone Harness Cloud 폰: adb로 쓰는 Android, 또는 HTTPS로 쓰는 iPhone
  ● agent: wants to open Weather
  │
  ● find_text("Weather") → (400, 468)
  │
  ● tap(400, 468) → reads the screen → forecast is up
  ✓ done

Phone Harness Cloud를 써 보세요 → 스텔스, 실제 번호, 2단계 인증, 무제한 기기를 갖춘 호스팅 iPhone과 Android

코딩 에이전트에 설정 프롬프트를 보내서 시작하세요.

데모

작업: "내 현재 위치에서 Delah Coffee까지 Waymo를 불러 줘."

에이전트가 phone-harness로 실제 iPhone에서 Delah Coffee까지 Waymo를 부르는 모습

설정

CLI를 쓰려면 에이전트(Claude Code, Codex, Grok Bot 등)에 이 설정 프롬프트를 보내세요.

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.

에이전트가 CLI를 설치하고, 어떤 폰을 쓸지 묻고, 사용자의 손이 필요한 단계를 안내합니다. 폰마다 필요한 것은 다음과 같습니다.

폰필요한 것
iPhonemacOS 15 이상, iOS 18 이상 iPhone과 짝지은 iPhone Mirroring, 손쉬운 사용 및 화면 기록 권한
Androidadb와 USB 디버깅, macOS · Linux · Windows 어디서든
클라우드 Android / iPhonePhone Harness Cloud 계정. 클라우드 Android는 adb도 필요

phone-harness doctor가 설정을 점검합니다. 자세한 내용: install.md와 setup/.

MCP: https://mcp.phone-harness.com/mcp를 아무 MCP 클라이언트에 추가하세요(설정). 지금은 클라우드 Android와 iPhone만 됩니다.

Hermes Agent: hermes plugins install phone-harness/phone-harness/integrations/hermes. integrations/hermes를 보세요.

OpenClaw: openclaw plugins install clawhub:phone-harness. integrations/openclaw를 보세요.

사용법

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.py에 있습니다. 에이전트는 자기가 만든 도우미를 ~/.phone-harness/agent-workspace에 저장합니다.

Phone Harness Cloud

책상 위에 폰이 없거나 여러 대가 필요한가요? Phone Harness Cloud가 대신 호스팅해 줍니다.

  • Android 폰을 필요할 때마다: 세션마다 새 폰이거나, 앱과 로그인을 그대로 유지하는 저장된 폰.
  • 전용 실제 iPhone을 어떤 OS에서든 HTTPS로 조작.
  • 에이전트가 일하는 동안 브라우저에서 보는 폰 실시간 화면.
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

같은 도우미로 클라우드 폰도 조작합니다. Android는 adb로, iPhone은 HTTPS로 다룹니다. cloud start는 cloud ls에 나오는 폰의 이름이나 id, 또는 ios / android를 받으며, 아무것도 주지 않으면 임시 Android를 시작합니다. phone-harness cloud를 실행하면 모든 명령이 나옵니다.

동작 방식

모든 폰이 같은 도우미 함수 뒤에 있어서, 한 폰용으로 쓴 스크립트가 다른 폰에서도 돌아갑니다.

  • iPhone: iPhone Mirroring 창을 캡처해 Apple Vision OCR로 읽고, 탭 · 스와이프 · 입력을 입력 이벤트로 보냅니다.
  • Android: 화면 캡처와 입력에는 adb, 글자 읽기에는 접근성 트리를 씁니다. USB 또는 Wi-Fi.
  • 클라우드 Android: Android와 같고, 호스팅된 폰에 adb로 연결합니다.
  • 클라우드 iPhone: HTTPS로 동작을 보냅니다.

phone-harness config set platform ios|android로 기본 폰을 고릅니다. phone-harness update는 CLI를 올리며, 새 버전이 나오면 한 줄을 알려 줍니다(PHONE_HARNESS_NO_UPDATE_CHECK=1이면 알리지 않습니다).

한계

  • iPhone 잠금을 풀면 미러링이 멈춥니다. PIN으로 잠긴 Android는 사용자가 풀어야 합니다.
  • OCR은 글자만 읽고 아이콘은 못 읽습니다. 이름 없는 컨트롤은 스크린샷과 비전 모델이 필요합니다.
  • 멀티터치, 카메라, Face ID 흐름은 안 됩니다. DRM 영상은 검게 보입니다.
  • 폰을 연결하는 일은 언제나 사용자의 몫입니다.

후원

phone-harness는 무료이고, 제 시간을 들여 관리하고 있습니다. 후원이 이를 이어 가게 해 줍니다.


저장소: phone-harness/phone-harness

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0