phone-harness
- 추천0
- GitHub 별5K
- 개발라이선스MIT
Claude Code · Codex 같은 에이전트가 진짜 폰(iPhone · Android · 클라우드 폰)을 탭 · 입력 · 화면 읽기로 쓰게 하는 CLI. MIT
요약
Claude Code · Codex 같은 에이전트가 진짜 폰(iPhone · Android · 클라우드 폰)을 탭 · 입력 · 화면 읽기로 쓰게 하는 CLI. MIT
설명
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를 불러 줘."

설정
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를 설치하고, 어떤 폰을 쓸지 묻고, 사용자의 손이 필요한 단계를 안내합니다. 폰마다 필요한 것은 다음과 같습니다.
| 폰 | 필요한 것 |
|---|---|
| iPhone | macOS 15 이상, iOS 18 이상 iPhone과 짝지은 iPhone Mirroring, 손쉬운 사용 및 화면 기록 권한 |
| Android | adb와 USB 디버깅, macOS · Linux · Windows 어디서든 |
| 클라우드 Android / iPhone | Phone 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는 무료이고, 제 시간을 들여 관리하고 있습니다. 후원이 이를 이어 가게 해 줍니다.
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0