Repolode
Submit
Samin100

Samin100/codex-ios-assistant

A CLI that lets Codex on a Mac control and inspect an iPhone through iMessage and an iOS Shortcut.

View on GitHub
Stars
271
Forks
35
Open issues
1
Last commit
2 months ago

What is it?

Codex iOS Assistant lets Codex running on a Mac send commands to an iPhone. The `iphone` CLI sends private commands over iMessage, an iOS Shortcut runs the requested action on the phone, and the result is returned to the Mac through an authenticated HTTPS endpoint exposed by a Cloudflare Tunnel.

Supported actions include reading visible screen text or saving a screenshot, reading and replacing the clipboard, listing and managing alarms, opening common iOS apps, toggling timers, the flashlight and Low Power Mode, placing calls, and searching Mac Contacts or the Mac's Messages database. Message composition only opens a draft for review; the CLI does not send ordinary messages, buy items, install apps, or request rides.

Installation requires a Mac on macOS 14 or newer, a domain managed in Cloudflare, and iCloud sync for Shortcuts. The Shortcut's automation trigger has to be created by hand in the iPhone Shortcuts app.

Key features

  • 01Reads visible iPhone screen text or saves a screenshot.
  • 02Reads and replaces the iPhone clipboard.
  • 03Lists, creates, and disables alarms.
  • 04Opens common iOS apps and controls timers, flashlight, and Low Power Mode.
  • 05Searches Mac Contacts and reads the Mac's Messages database.
  • 06Returns phone responses to the Mac over an authenticated Cloudflare Tunnel.

Use cases

  • Letting Codex check what is on your iPhone screen while debugging a mobile flow.
  • Moving text between the Mac and iPhone clipboard during a task.
  • Asking Codex to set or review alarms and timers remotely.
  • Looking up Mac contacts or recent messages from within a Codex session.

Quick start

  1. 1

    Clone the repository

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

    Enter the project folder

    cd codex-ios-assistant
  3. 3

    Install cloudflared and imsg with Homebrew

    brew install cloudflared steipete/tap/imsg
  4. 4

    Run the installer script

    ./scripts/install

Things to know

  • Requires a Mac running macOS 14 or newer.
  • Requires a domain managed in Cloudflare for the HTTPS tunnel.
  • You must create the iPhone Shortcut automation by hand, and iCloud sync for Shortcuts is required.
  • The ChatGPT desktop and mobile apps are needed for the Remote workflow.

Topics

#ios#imessage#ios-shortcuts#automation#cloudflare-tunnel#macos#remote-control

FAQ

What is codex-ios-assistant?
A CLI that lets Codex on a Mac control and inspect an iPhone through iMessage and an iOS Shortcut. Codex iOS Assistant lets Codex running on a Mac send commands to an iPhone. The `iphone` CLI sends private commands over iMessage, an iOS Shortcut runs the requested action on the phone, and the result is returned to the Mac through an authenticated HTTPS endpoint exposed by a Cloudflare Tunnel.
Is codex-ios-assistant free to use? What license does it have?
codex-ios-assistant is open source under the MIT license. Check the license terms before using it in commercial products.
Is codex-ios-assistant still maintained?
Updated within 6 months. The last commit to codex-ios-assistant was on Aug 7, 2026.
What can I use codex-ios-assistant for?
Letting Codex check what is on your iPhone screen while debugging a mobile flow. Moving text between the Mac and iPhone clipboard during a task. Asking Codex to set or review alarms and timers remotely. Looking up Mac contacts or recent messages from within a Codex session.
How do I install codex-ios-assistant?
Clone the repository: git clone https://github.com/samin100/codex-ios-assistant.git Enter the project folder: cd codex-ios-assistant Install cloudflared and imsg with Homebrew: brew install cloudflared steipete/tap/imsg Run the installer script: ./scripts/install
Where can I get codex-ios-assistant?
The source code and installation instructions are on GitHub: https://github.com/Samin100/codex-ios-assistant

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects