先说结论
Codex 的长任务动辄跑十几分钟甚至更久，人离开电脑后，最想知道的就三件事：它还在跑吗、卡在哪里了、跑完了没有。BotBus 的做法是在 Mac 上常驻一个菜单栏应用，只读地读取本机 Codex 的会话记录，把任务状态、最近一条输出和按需取回的完整对话同步到 iPhone 和 Apple Watch。你不用改变启动 Codex 的方式，终端里、Codex 桌面 app 里开的会话都会出现在手机上。
这篇说的是跑在你自己电脑上的 Codex。下面分步讲它怎么工作、手机上能看到什么、什么时候会提醒你，以及哪些情况只能看不能操作。
为什么“看进度”本身就值得单独解决
很多人第一反应是“我要的是远程控制”。但实际用下来，大部分时候你并不需要插手：agent 在按计划改代码、跑测试，你只是想确认它没有停在某个审批上，也没有在错误的方向上越走越远。如果每次确认都得回到电脑前，要么你一直惦记着，要么任务在你看不见的地方白等了半小时。
所以看进度要做到三点：第一，状态要准，运行中、等审批、等回复、已完成、失败要分得清；第二，内容要够，光有一个“运行中”没用，得能看到它最近在说什么、改了哪些文件；第三，打扰要少，只在需要你的时候提醒，而不是每一步都弹通知。
BotBus 是怎么拿到 Codex 进度的
只读观察本机的 Codex 记录
Codex 会把会话线程记在本机 ~/.codex 目录下的 SQLite 数据库里。BotBus 大约每 2 秒读一次这些数据库，从里面整理出任务列表：标题取线程名或第一条用户消息的前 80 个字，另外带上最后一条 agent 消息的前 500 个字和当前状态。它只读不写：不改 ~/.codex，不往 Codex 里塞任何东西，所以不会影响你正在用的 Codex。如果你把 Codex 数据放在别的目录，可以在 BotBus 设置里改。
同步到手机
整理好的任务按电脑和项目分组，经中转服务器同步到手机。手机端用长轮询拉取最新状态，打开 app 就是当前的样子。多台 Mac 可以配对到同一部手机上，每台电脑的任务分开列出，不会混在一起。
按需读完整对话
列表里只放摘要。想知道 agent 这一路具体做了什么，点进任务可以取回完整对话：BotBus 从 Codex 的历史库里读出来，加密后交给手机。这一步只在你点开时发生，不会把所有对话一股脑传上去。对话里你发过的图和 Codex 生成的图也能看到；浏览器、模拟器这类工具截图只保留一行文字说明。
看代码改了什么
如果任务所在的项目是 git 仓库，手机上的任务详情还能看到这个项目里还没提交的改动：先是文件清单和增删行数，点进单个文件可以看新旧对照的差异。只有确实有改动时才会出现这个入口。这对判断“它是不是走偏了”非常有用，比只看文字总结直观得多。
什么时候会提醒你
BotBus 的通知分四类：有任务等你审批、等你回复、任务完成、任务失败。其余时间它不打扰你，状态变化只在你打开 app 时看到。
几个细节：通知要在手机上允许推送权限才能收到；app 在前台时不会弹横幅，因为你本来就在看；Apple Watch 上会先显示一句固定的提示，打开手表 app 后再解密显示具体内容。点开通知会直接跳到对应的任务。
电脑上也有一个一眼能看的地方：菜单栏图标会随状态变化，任务在跑时眼睛左右扫视，有任务等审批时两盏头灯交替闪，刚跑完时会笑一下，右边还会显示待处理的数量。
看完之后还能做什么
看进度是起点。在条件满足时，手机上还可以直接处理：
- 审批：Codex 要执行命令、改文件或申请权限时，手机上会出现审批卡片，可以允许或拒绝。Codex 通过提问让你选择时，选项也会显示在手机上。
- 续聊：给这个会话补一句话，比如“测试挂了先别提交”。续聊时还能换模型和思考强度。
- 中断：发现方向不对，可以直接停下这一轮。
这些操作都要求那台电脑在线，并且由对应的连接器支持。Claude Code 的审批流程有所不同，见在手机上审批 Claude Code。
Codex 桌面 app 里开的会话
Codex 桌面 app 自己会拉起一个进程来管会话。想让手机和桌面同时操作同一个会话，第一次接入时先完成桌面上的当前任务、退出 Codex，然后从 BotBus 菜单栏「本机 Agent」里 Codex 那一行点「启动 Codex」。这样启动的桌面 app 和 BotBus 共用同一条通道，审批以先回答的一端为准，你在手机和电脑上看到的是同一个会话。
如果桌面 app 已经从 Dock 独立打开，BotBus 会在同一位置显示感叹号按钮，说明手机续聊的限制，并提供「立即重启 Codex」。重启会中断正在跑的任务，所以它会先提醒你。
限制与边界
- 看不需要电脑在线，操作需要。 已经同步的任务，电脑离线后仍留在手机上，只是标成离线；审批、续聊、新建和中断都要那台电脑在线。
- 有些任务只能看。 会话正被另一个 Codex 进程持有时，手机续聊会提示
already has an active writer。这时先完成电脑上的任务并退出那个 Codex，再从 BotBus 菜单栏启动它，回到手机上打开原任务继续即可，不用新建会话。 - 不是逐秒直播。 列表大约每 2 秒刷新一次，标题和最后一条输出都是截断后的摘要，想看全貌要点进对话。
- 通知取决于系统。 推送能不能到，还取决于手机的通知权限和系统设置。
- 内容端到端加密，但不是什么都藏得住。 任务标题、对话、改动和通知正文都在设备上加密后才发出，钥匙只经电脑屏幕上的配对二维码交给手机。服务器仍然看得到设备编号、在线状态、更新时间和数据大小，任务编号的前缀也能看出它来自 Codex。细节见端到端加密说明。
现在能不能用
电脑端有 Mac 版（菜单栏应用，需要 macOS 26 或更新）和 Linux 版（x86_64 / aarch64 的命令行程序，见安装说明），都可以在官网下载；上文的菜单栏图标与「启动 Codex」说的是 Mac 版。iPhone 和 Apple Watch 版已在 App Store 上架；Windows 与 Android 版在计划中。除了 Codex，BotBus 也接入了 Claude Code、Hermes、Pi、OpenClaw 和 DeepSeek Harness，多种 agent 的任务可以在同一个手机 app 里看。
常见问题
BotBus 会改动我的 Codex 数据吗？
不会。它只读 ~/.codex 里的数据库来整理任务列表，不写入、不改结构。从手机发起的操作走 Codex 自己的 codex app-server 接口，而不是直接改数据库。
我在终端里跑的 codex 也能在手机上看到吗？
能。只要会话记录写进了本机的 Codex 数据目录，无论从终端还是桌面 app 开的，都会出现在任务列表里。
电脑合上盖子睡眠了，手机上还能看到什么？
能看到睡眠前最后同步的状态，电脑会被标成离线。Codex 本身在电脑睡眠时也不会继续跑，醒来后状态会接着同步。
能在 Apple Watch 上看 Codex 进度吗？
可以。手表从 iPhone 同步配对信息后自己联网，能看任务列表、处理审批和回复，不用每次都掏手机。
手机上会看到别人的任务吗？
不会。只有你用配对二维码配对过的设备才拿得到钥匙，任务只在你自己的这组电脑、手机和手表之间同步。