1. 项目定位与用途
Remodex 是一个本地优先的开源桥接+iOS 应用组合，核心定位是作为 Codex AI 编程助手的远程控制终端。它允许用户通过 iPhone 安全地连接并操控运行在 Mac 上的 Codex 服务，实现移动化的代码生成监控、任务干预与 Git 操作，同时将代码与数据保留在本地，避免上传至第三方云端。
项目档案应用项目
Remodex：远程控制 Codex 的 iOS 应用 | 安装与使用指南
Emanuele-web04/remodex：Remodex 是一款本地优先的开源桥接与 iOS 应用，让你通过 iPhone 远程控制 Mac 上的 Codex AI 编程助手，实现端到端本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Remodex 是一款本地优先的开源桥接与 iOS 应用，让你通过 iPhone 远程控制 Mac 上的 Codex AI 编程助手，实现端到端加密的实时交互与 Git 操作，兼顾便捷性与数据隐私。
中文项目介绍
Remodex 是一个将 Codex AI 编程助手的控制权延伸到移动设备的解决方案。它通过一个在 Mac 上运行的后台桥接服务，将 iPhone 与本地 Codex 运行时连接起来，解决了 Codex 传统上只能通过桌面应用使用的限制。
用户可以在 iPhone 上实时查看 Codex 的流式响应、发送后续提示、队列请求，并直接执行 Git 操作（如提交、推送、分支切换），而无需始终守在电脑前。所有核心计算与数据（包括 Git 操作）均在用户的 Mac 上本地执行，中继服务仅转发加密消息，从而在提供远程控制便利的同时，最大程度保障隐私与数据自主权。
项目采用三层架构：iOS 客户端、Mac 桥接服务（支持 launchd 后台守护）、以及本地 Codex app-server，三者通过 WebSocket 和 stdin/stdout 以 JSON-RPC 协议通信。安全模型基于 X25519 密钥交换与 AES-256-GCM 加密，确保配对会话的端到端安全。
详细信息与使用说明
2. 解决的问题
主要解决 Codex 使用场景的移动性与连续性问题：传统 Codex 需固定在 Mac 前操作，无法远程响应或干预。Remodex 通过建立安全的远程通道，使用户能随时随地查看生成进度、发送新指令、队列后续提示，并执行 Git 操作，提升了开发流程的灵活性与效率，同时通过本地优先设计规避了云端隐私顾虑。
3. 适用场景
适用于需要远程监控或干预 Codex 任务的开发者：例如在移动中查看长时间运行的代码生成进度、快速提交紧急修复、切换分支验证想法、或在不方便使用电脑时发送后续提示。也适合注重数据隐私、希望完全自托管 AI 编程工具的用户，以及需要在多设备间同步线程历史的团队协作场景。
4. 安装方式
iOS 端：从 App Store 下载 Remodex 应用，或使用 Xcode 从源码构建并签名安装到设备。Mac 端：在终端运行 `remodex up` 命令，该命令会安装并启动轻量级后台桥接服务（macOS 通过 launchd），并在首次运行时输出配对用的 QR 码。自建中继用户需设置 `REMODEX_RELAY` 环境变量指向中继地址。
5. 使用方式
1. 在 Mac 上执行 `remodex up` 启动桥接并显示 QR 码；2. 打开 iPhone 上的 Remodex App，扫描 QR 码完成首次信任配对；3. 配对后，iPhone 自动通过中继重连至 Mac 的活跃会话；4. 在 App 中创建或选择线程，发送提示词，实时查看 Codex 的流式响应；5. 使用 Fast/Plan 模式、/subagents 命令、调整推理强度与访问控制，或通过内置终端执行 Git 操作。
6. 补充说明与实现特点
项目实现强调本地优先与可自检性：iOS 应用不嵌入公有云端点，传输层完全可 inspect。macOS 支持自动后台重连（launchd），其他 OS 需通过自建中继使用前台桥接模式。桥接服务负责管理 Codex 进程、执行本地 Git 命令、持久化会话，并与 Codex app-server 通过 stdin/stdout 进行 JSON-RPC 通信。中继仅转发加密消息，不解密应用层数据。当前版本尚处早期，可能存在 bug，且暂未 actively 接受外部贡献。
思维导图
Remodex
iOS 应用前端
SwiftUI 界面
线程管理与历史
提示词输入与流式显示
Git 操作面板
设置（推理强度/访问控制）
Mac 桥接服务
launchd 后台守护（macOS）
WebSocket 连接管理
Codex 进程启停
本地 Git 命令执行
会话持久化
安全传输层
端到端加密配对
X25519 密钥交换
AES-256-GCM 数据加密
可信自动重连
Codex 通信适配器
JSON-RPC over stdin/stdout
流式响应转发
桌面刷新与队列管理
中继服务
会话房间管理
加密消息转发
不处理明文数据
常见问题
如何首次配对 iPhone 与 Mac？
在 Mac 上运行 `remodex up` 命令，启动桥接服务并屏幕上会显示一个 QR 码。打开 iPhone 上的 Remodex App，扫描该 QR 码即可完成首次信任握手。注意：若在安装 App 前用通用相机扫描，可能无法正确触发配对流程。
是否支持 Windows 或 Linux？
可以，但体验有差异。Windows 和 Linux 用户可通过自建中继使用 Remodex，但当前仅 macOS 支持通过 launchd 实现的后台守护与自动重连；其他系统使用前台桥接模式，需保持终端会话运行。项目已修复 Windows 上的 Codex 启动路径问题。
数据隐私如何保障？所有代码会发送到云端吗？
不会。Remodex 采用本地优先设计：Codex 运行时、Git 操作及所有会话数据均保留在你的 Mac 上。中继服务仅作为加密消息转发层，不存储也不解密任何应用层内容。iOS 应用不嵌入任何公有云端点，整个传输链路可审查，适合对隐私敏感的用户。
使用 Remodex 需要单独安装 Codex 吗？
需要。Remodex 桥接服务仅作为控制通道，它依赖本地已安装并配置好的 Codex CLI（`codex` 命令）及其 app-server 组件。请确保你的 Mac 上已正确安装 Codex 并能正常运行 `codex app-server`。
如果遇到连接或启动问题，如何排查？
首先确认 Mac 上 `codex` 命令可用。运行 `remodex up` 时观察终端输出，桥接会打印启动命令和错误信息。若在 Windows 上遇到 `spawn codex ENOENT`，说明 CLI 路径问题，项目已提供平台适配的启动方案。也可查阅仓库中的 `Docs/RECAP-windows-codex-launch.md` 等复盘文档了解已知修复。