AI product Open source
Codex iOS Assistant is an open-source system for controlling and inspecting an iPhone from Codex running on a Mac. Its `iphone` CLI sends private commands through iMessage to an iOS Shortcut; the Shortcut performs native iOS actions and returns device context through an authenticated HTTPS response routed via Cloudflare Tunnel to a receiver on the Mac. A per-user macOS LaunchAgent runs the Messages sender outside the Codex sandbox over a Unix socket.
The system can read visible screen text, save screenshots, access or replace the clipboard, manage alarms, open specified apps, control timers, the flashlight, and Low Power Mode, place calls, and read Mac Contacts and the Mac Messages database. Message composition creates a draft for review; the CLI does not send ordinary messages, make purchases, install apps, order food, or request rides.
It requires macOS 14 or newer, Python 3.11 or newer, Messages, Xcode Command Line Tools, an iPhone reachable at a configured iMessage address, iCloud sync for Shortcuts, and a Cloudflare-managed domain. Installation uses the repository scripts and creates an iOS Shortcut containing 95 native Shortcuts actions, with a manually configured iPhone message automation.
1 use taken from transcripts — each links to the moment in the video.
A system that lets Codex on a Mac inspect and control an iPhone through iMessage and Apple Shortcuts. It can read visible screen text, manage alarms, and toggle settings using authenticated commands, while excluding ordinary messages and purchases.
1 in the library.