Repolode
Samin100

Samin100/codex-ios-assistant

让 Mac 上的 Codex 通过 iMessage 和快捷指令远程控制与查看 iPhone。

Star
271
Fork
35
未关闭 Issue
1
最近提交
2个月前

这是什么?

Codex iOS Assistant 让运行在 Mac 上的 Codex 向 iPhone 下发指令。`iphone` 命令行工具通过 iMessage 发送私有命令,iOS 快捷指令在手机上执行对应操作,结果再经由 Cloudflare Tunnel 暴露的带鉴权 HTTPS 接口回传到 Mac。

支持的操作包括读取屏幕可见文字或保存截图、读写剪贴板、查看和管理闹钟、打开常用 iOS 应用、控制计时器、手电筒和低电量模式、拨打电话,以及搜索 Mac 通讯录和读取 Mac 上的信息数据库。编写短信只会打开草稿供确认,命令行工具不会直接发送普通消息、购物、安装应用或叫车。

安装需要 macOS 14 或更新版本的 Mac、由 Cloudflare 管理的域名,并开启快捷指令的 iCloud 同步。快捷指令的自动化触发器需要在 iPhone 的快捷指令 App 中手动创建。

核心功能

  • 01读取 iPhone 屏幕可见文字或保存截图。
  • 02读取和替换 iPhone 剪贴板。
  • 03列出、创建和关闭闹钟。
  • 04打开常用 iOS 应用,并控制计时器、手电筒和低电量模式。
  • 05搜索 Mac 通讯录并读取 Mac 上的信息数据库。
  • 06通过带鉴权的 Cloudflare Tunnel 把手机结果回传到 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 同步。
  • 远程工作流需要 ChatGPT 桌面版和移动版应用。

标签

常见问题

codex-ios-assistant 是什么?
让 Mac 上的 Codex 通过 iMessage 和快捷指令远程控制与查看 iPhone。 Codex iOS Assistant 让运行在 Mac 上的 Codex 向 iPhone 下发指令。`iphone` 命令行工具通过 iMessage 发送私有命令,iOS 快捷指令在手机上执行对应操作,结果再经由 Cloudflare Tunnel 暴露的带鉴权 HTTPS 接口回传到 Mac。
codex-ios-assistant 可以免费使用吗?用的什么许可证?
codex-ios-assistant 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
codex-ios-assistant 还在维护吗?
半年内有更新。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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目