프로젝트 소개

Phone Harness는 Claude Code나 Codex 같은 코딩 에이전트를 실제 폰에 연결하는 도구입니다. Mac의 iPhone Mirroring 창을 통한 iPhone과 macOS, Linux, Windows에서 adb를 통한 Android를 지원합니다. 탈옥, Xcode, 폰에 설치하는 소프트웨어가 필요하지 않습니다. 에이전트는 화면을 보고, 탭 가능한 좌표와 함께 텍스트를 찾고, 탭하고, 스와이프하고, 입력하고, 결과를 읽을 수 있습니다. 설정 프롬프트를 통해 에이전트가 도구를 복제 및 설치하고, 에이전트 스킬로 등록하고, 사용자에게 페어링 단계를 안내할 수 있습니다. `--doctor` 명령은 연결 체인을 확인합니다. iPhone의 경우, 하네스는 미러링 창을 캡처하고, Apple의 Vision 프레임워크로 OCR을 수행하며, 탭, 스와이프, 입력을 위해 HID 수준 이벤트를 게시합니다. Android의 경우, 캡처를 위해 `screencap`과 함께 adb를 사용하고, 텍스트를 위해 접근성 트리를 사용하며, USB 또는 Wi-Fi를 통한 작업을 위해 `input`을 사용합니다. 동일한 헬퍼가 두 플랫폼 모두에서 작동합니다. 클라우드 옵션은 adb를 통해 접근 가능한 호스팅 Android 폰을 제공하며, 지속적인 앱과 로그인을 지원하고 처음 100분은 무료입니다. 문서화된 제한 사항으로는 멀티터치 불가, 카메라 또는 Face ID 흐름 불가, DRM 비디오 렌더링 검은 화면, 사용자가 폰 잠금 해제와 연결을 처리해야 한다는 점이 있습니다.