zhongerxin/iPhone-use

어떤 프로젝트인가요?

핵심 기능

• 01WebDriverAgent를 통해 USB로 실제 iPhone을 조작합니다.
• 02모델이 사용할 수 있도록 간결한 접근성 트리와 스크린샷을 읽습니다.
• 03탭, 스와이프, 드래그, 유니코드 텍스트 입력, 동작 일괄 실행을 지원합니다.
• 04스크롤하면서 목록 항목을 수집하고, 겹치는 항목을 처리해 중복을 제거합니다.
• 05일시 중지 및 제어권 인계 상태를 표시하는 실시간 휴대폰 화면 위젯을 제공합니다.
• 06안내에 따라 Codex, WorkBuddy, Doubao에 설치할 수 있습니다.

활용 사례

• AI 어시스턴트가 개인 iPhone에서 앱을 열고 여러 단계로 이루어진 작업을 수행하게 합니다.
• 스크롤을 이용해 iPhone 앱의 목록 콘텐츠를 수집하거나 정리합니다.
• 데스크톱 어시스턴트에서 iOS 앱의 흐름을 테스트하거나 살펴봅니다.
• 사용자가 내용을 검토하고 제출할 수 있도록 휴대폰 앱에 텍스트 초안을 작성합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/zhongerxin/iPhone-use.git
2. 2

   프로젝트 디렉터리로 이동합니다

   cd iPhone-use
3. 3

   설치 스크립트를 실행합니다

   sh scripts/install.sh

사용 전 알아둘 점

• !macOS, 전체 Xcode, USB로 연결된 iPhone이 필요합니다.
• !먼저 자신의 Apple 개발자 계정으로 WebDriverAgent에 서명하고 자신의 iPhone에서 실행해야 합니다.
• !독립 실행형 도구라기보다 주로 Codex, WorkBuddy 또는 Doubao용 플러그인으로 설계되었습니다.
• !README에 따르면 저장소는 현재 비공개이므로 GitHub 액세스 권한이나 소스 패키지가 필요합니다.

토픽

자주 묻는 질문

iPhone-use은(는) 무엇인가요?

WebDriverAgent를 통해 USB로 실제 iPhone을 조작하고 화면을 실시간 미리보기로 보여 주는 Codex, WorkBuddy, Doubao 플러그인입니다. iPhone Use는 USB로 연결된 실제 iPhone을 AI 어시스턴트와 연결합니다. 자연어로 작업을 요청하면 어시스턴트가 앱을 열고, 화면을 읽고, 탭하거나 스와이프하고, 텍스트를 입력하고, 목록 항목을 수집할 수 있으며, 사이드바 위젯에는 휴대폰 화면이 실시간으로 표시됩니다. 휴대폰에서 자동화 서비스로 실행되는 WebDriverAgent(WDA)를 기반으로 하며, 로컬 MCP 서버, 설정 및 사용법을 안내하는 스킬, 화면 위젯도 포함합니다.

iPhone-use은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

iPhone-use은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

iPhone-use은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. iPhone-use의 마지막 커밋은 2026년 10월 16일입니다.

iPhone-use은(는) 어디에 사용할 수 있나요?

AI 어시스턴트가 개인 iPhone에서 앱을 열고 여러 단계로 이루어진 작업을 수행하게 합니다. 스크롤을 이용해 iPhone 앱의 목록 콘텐츠를 수집하거나 정리합니다. 데스크톱 어시스턴트에서 iOS 앱의 흐름을 테스트하거나 살펴봅니다. 사용자가 내용을 검토하고 제출할 수 있도록 휴대폰 앱에 텍스트 초안을 작성합니다.

iPhone-use는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/zhongerxin/iPhone-use.git 프로젝트 디렉터리로 이동합니다: cd iPhone-use 설치 스크립트를 실행합니다: sh scripts/install.sh

iPhone-use은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zhongerxin/iPhone-use