同一條會話上下文
手機端以桌面 Bridge 的 thread、project 與 runtime 為準，避免再維護一條分叉任務線。
Codex On iPhone
讓 iPhone 接續你的 Mac Codex 工作流
CodexMobile 把 iPhone、Mac 菜單欄與 VPS Relay 串成同一條工作流。 離開電腦後，你仍能查看桌面端會話、補充需求、處理審批、接收桌面截圖，並在回到 Mac 後接續同一個專案與上下文。
iPhone → VPS → Mac
單一路徑中轉
Live 會話延續
不另起一條手機任務線
開源可自部署
附 Nginx、systemd 與站點範本
You
幫我在 webhook 入口加上更完整的錯誤處理。
Processing steps
2.3s
我會先補 try/catch、輸入驗證與統一錯誤回應，再把修改過的檔案摘要同步到手機端。
2 個文件已更改
+19 -2
src/api/webhook.ts
+8 -2
src/utils/validation.ts
+11
手機端會話、文件變更、審批卡片與桌面截圖，盡量與桌面端資料源保持同源。
發送訊息給 Codex…
Core Capabilities
不是把桌面畫面搬到手機，而是延續同一條 Codex 工作流
Mac 菜單欄常駐
提供開機自啟、自動連線、重新檢查連線、保持喚醒與桌面截圖回傳等常用操作。
VPS Relay 中轉
手機先連到對外 API，再由 VPS Relay 轉回 Mac 本機服務，適合帶著 MacBook 移動辦公。
文件與審批同步
手機端可查看文件變更、審批卡片、處理中的步驟資訊，並盡量與桌面端顯示對齊。
Architecture
三段式架構：手機 App、VPS Relay、Mac 本機服務
iPhone
CodexMobile App
顯示桌面端會話、輸入訊息、處理審批、管理附件與桌面截圖預覽。
→
VPS
App API / Relay
驗證 Token、轉發手機端請求、暴露對外域名，並保持手機可從外網連回桌面端。
→
Mac
Desktop Bridge
對接 Codex app-server 與 Mac 本機服務，把 thread、runtime、檔案變更與狀態同步給手機端。
Get Started
把安装、部署和操作说明拆到独立页面
Hosting Options
你可以自建，也可以使用官方代管服務
自建 VPS
如果你有自己的 VPS、域名與 HTTPS 環境，可以完全自部署。安裝頁與部署頁已提供目錄初始化、systemd、Nginx、DNS 與 Token 的完整說明。
官方域名 / 官方 VPS
如果你不自行準備 VPS，而是直接使用 codexmobile.app 相關官方域名與官方 Relay
服務，這屬於付費托管服務，不屬於開源倉庫默認免費提供的能力。
Open Source
開源後，你可以直接 fork、部署、改成自己的 Relay 與品牌
倉庫內已包含 App、Mac 菜單欄、Python 服務、Nginx 站點與部署範本。對外發布前，建議先清理預設路徑、Token、日誌與本機構建產物。