Repolode
Samin100

Samin100/codex-ios-assistant

Mac의 Codex가 iMessage와 iOS Shortcut을 통해 iPhone을 제어하고 상태를 확인할 수 있게 해 주는 CLI입니다.

스타
271
포크
35
열린 이슈
1
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Codex iOS Assistant를 사용하면 Mac에서 실행 중인 Codex가 iPhone에 명령을 보낼 수 있습니다. `iphone` CLI가 iMessage로 비공개 명령을 보내면 iOS Shortcut이 iPhone에서 요청된 작업을 실행하고, Cloudflare Tunnel을 통해 공개된 인증된 HTTPS 엔드포인트를 거쳐 결과를 Mac으로 반환합니다.

지원 작업에는 화면에 표시된 텍스트 읽기 또는 스크린샷 저장, 클립보드 읽기 및 교체, 알람 목록 조회와 관리, 자주 사용하는 iOS 앱 열기, 타이머·손전등·저전력 모드 전환, 전화 걸기, Mac 연락처 또는 Mac의 Messages 데이터베이스 검색이 포함됩니다. 메시지 작성 기능은 검토할 수 있도록 초안만 열어 줍니다. CLI는 일반 메시지를 보내거나, 물품을 구매하거나, 앱을 설치하거나, 차량 호출을 요청하지 않습니다.

설치하려면 macOS 14 이상을 실행하는 Mac, Cloudflare에서 관리하는 도메인, Shortcuts의 iCloud 동기화가 필요합니다. iPhone의 Shortcuts 앱에서 Shortcut 자동화 트리거를 직접 만들어야 합니다.

핵심 기능

  • 01iPhone 화면에 표시된 텍스트를 읽거나 스크린샷을 저장합니다.
  • 02iPhone 클립보드를 읽고 내용을 교체합니다.
  • 03알람을 조회하고, 만들고, 비활성화합니다.
  • 04자주 사용하는 iOS 앱을 열고 타이머, 손전등, 저전력 모드를 제어합니다.
  • 05Mac 연락처를 검색하고 Mac의 Messages 데이터베이스를 읽습니다.
  • 06인증된 Cloudflare Tunnel을 통해 iPhone의 응답을 Mac으로 반환합니다.

활용 사례

  • 모바일 흐름을 디버깅하는 동안 Codex가 iPhone 화면에 무엇이 표시되어 있는지 확인하게 합니다.
  • 작업 중 Mac과 iPhone의 클립보드 사이에서 텍스트를 옮깁니다.
  • Codex에 원격으로 알람과 타이머를 설정하거나 확인하도록 요청합니다.
  • Codex 세션에서 Mac 연락처나 최근 메시지를 찾아봅니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/samin100/codex-ios-assistant.git
  2. 2

    프로젝트 폴더로 이동합니다

    cd codex-ios-assistant
  3. 3

    Homebrew로 cloudflared와 imsg를 설치합니다

    brew install cloudflared steipete/tap/imsg
  4. 4

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

    ./scripts/install

사용 전 알아둘 점

  • macOS 14 이상을 실행하는 Mac이 필요합니다.
  • HTTPS 터널을 위해 Cloudflare에서 관리하는 도메인이 필요합니다.
  • iPhone 단축어 자동화는 직접 만들어야 하며, 단축어의 iCloud 동기화도 필요합니다.
  • Remote 워크플로에는 ChatGPT 데스크톱 앱과 모바일 앱이 필요합니다.

토픽

자주 묻는 질문

codex-ios-assistant은(는) 무엇인가요?
Mac의 Codex가 iMessage와 iOS Shortcut을 통해 iPhone을 제어하고 상태를 확인할 수 있게 해 주는 CLI입니다. Codex iOS Assistant를 사용하면 Mac에서 실행 중인 Codex가 iPhone에 명령을 보낼 수 있습니다. `iphone` CLI가 iMessage로 비공개 명령을 보내면 iOS Shortcut이 iPhone에서 요청된 작업을 실행하고, Cloudflare Tunnel을 통해 공개된 인증된 HTTPS 엔드포인트를 거쳐 결과를 Mac으로 반환합니다.
codex-ios-assistant은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
codex-ios-assistant은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
codex-ios-assistant은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. codex-ios-assistant의 마지막 커밋은 2026년 8월 7일입니다.
codex-ios-assistant은(는) 어디에 사용할 수 있나요?
모바일 흐름을 디버깅하는 동안 Codex가 iPhone 화면에 무엇이 표시되어 있는지 확인하게 합니다. 작업 중 Mac과 iPhone의 클립보드 사이에서 텍스트를 옮깁니다. Codex에 원격으로 알람과 타이머를 설정하거나 확인하도록 요청합니다. Codex 세션에서 Mac 연락처나 최근 메시지를 찾아봅니다.
codex-ios-assistant는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/samin100/codex-ios-assistant.git 프로젝트 폴더로 이동합니다: cd codex-ios-assistant Homebrew로 cloudflared와 imsg를 설치합니다: brew install cloudflared steipete/tap/imsg 설치 스크립트를 실행합니다: ./scripts/install
codex-ios-assistant은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Samin100/codex-ios-assistant

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트