把 iPhone 变成 Windows、Mac 和 Linux 电脑的触控板、隔空鼠标和语音文字输入遥控器。
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
克隆仓库
git clone https://github.com/samin100/codex-ios-assistant.git - 2
进入项目目录
cd codex-ios-assistant - 3
使用 Homebrew 安装 cloudflared 和 imsg
brew install cloudflared steipete/tap/imsg - 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 数据每日更新。
相关项目
跨平台的命令行 Shell、脚本语言与自动化框架,支持 Windows、Linux 和 macOS。
为 AI 编程代理提供构建、测试和运行 iOS/macOS Xcode 项目工具的 MCP 服务与命令行工具。
基于 URLSession 构建的 Swift HTTP 网络库,提供链式请求、参数编码、上传下载与响应校验。
一款 Ruby 命令行工具,用于自动化 iOS 和 Android 应用的构建、截图、签名与发布。
一款去中心化聊天应用,离线时通过蓝牙 mesh 组网,联网时经 Nostr 中继通信,无需账号或手机号。