Codex Reset — 自动恢复被用量限制暂停的 Codex 对话

它能做什么

用量一目了然菜单栏显示用量进度环 + 百分比，另有 5 小时 / 1 周用量条、下次重置倒计时与点数余额。

找出被暂停的对话自动识别所有因用量限制暂停的线程，并显示恢复时间。

到点自动继续5 小时窗口重置后，自动把指令（默认「继续」）发送到每一个你勾选的对话。

浏览并勾选任意对话按项目列出全部对话——不只暂停的，任何对话都可以恢复。

双击跳转到对话直接在当前 Codex 应用中打开该对话。

用量历史时间线每次窗口重置都会自动记录，帮你掌握每天额度恢复的确切时间。

下载

⬇️

下载 Codex Reset（macOS）

免费且开源（MIT）。全部功能都在本地运行——无需账号、无遥测，你的对话永远不会离开你的电脑。

macOS 14+Apple Silicon / Intel约 3.4 MBMIT License

下载 CodexReset-macOS-1.0.0.zip 在 GitHub 查看

首次打开（Gatekeeper）
应用已用 Apple Development 证书签名，但尚未公证。如果 macOS 提示无法验证开发者：请右键 Codex Reset.app 选择「打开」，或在「系统设置 → 隐私与安全性」中点击「仍要打开」。

SHA-256 校验值: e6e0f58522c2359c1ee7bcfca451626874e00da10b39736b4b595f3ac7fd0985

使用指南

环境要求

macOS 14 及以上
已安装 Codex 桌面端（Codex Reset 是配套工具，不捆绑 Codex）

作为菜单栏应用安装

git clone https://github.com/boyso/codex-reset.git
cd codex-reset
./make_app.sh              # builds & installs /Applications/Codex Reset.app
./install_launchagent.sh   # optional: auto-start at login

从菜单栏打开应用即可。它会安静地在后台运行，用量恢复后自动继续你勾选的对话。

或使用命令行

./Codex Reset --query                    # print usage + paused threads
./Codex Reset --continue <thread_id>     # resume one thread right now

面板要点

状态栏显示用量环 + 百分比；达到上限时切换为恢复倒计时。
概览：暂停对话（按项目分组并显示恢复时间）、全部对话列表，自动继续卡片固定在底部。
自动继续总开关——默认不预选任何对话，由你决定恢复哪些。
「用量历史」Tab 记录每次窗口重置；「日志」Tab 显示中英双语的运行日志。
右上角齿轮打开设置：是否显示全部对话、语言（English / 简体中文）、remote_control。
双击任意一行可在 Codex 中打开该对话；需要全量恢复时可使用各区域的「全选」。

工作原理

Codex Reset 通过两条通道与你本地的 Codex 通信，优先使用更可靠的通道：

本地 app-server — 连接 Codex 自带的本地服务并开启新的一轮对话，快速、可脚本化、无需任何权限。
GUI 兜底 — 如果桌面端正占着该对话，它通过深链打开 Codex、聚焦输入框、粘贴你的指令并用 ⌘Enter 发送。这条通道需要辅助功能权限。

隐私：一切都在本地完成。Codex Reset 以只读方式读取 ~/.codex 数据，不会向任何地方发送你的内容。无账号、无遥测。

常见问题

这是 OpenAI 的官方产品吗？

不是。Codex Reset 是独立开发的开源工具，与 OpenAI 无关联，也未经其认可。

自动继续会消耗我的用量吗？

和手动继续消耗的方式一致。它只恢复已经在进行中的工作——不会超过你的套餐额度，而且只在额度重置后才运行。

安全吗？会碰我的数据吗？

它只以只读方式读取本地的 ~/.codex 状态/历史数据库，并与 Codex 的本地服务通信。所有内容都不会离开你的 Mac。

为什么会请求辅助功能权限？

只有 GUI 兜底通道才需要——当桌面端占着对话时向 Codex 窗口输入内容。在设置中开启 remote_control 并重启 Codex 后，将改走协议通道，无需该权限。

Codex 更新后还能用吗？

Codex Reset 基于本地行为逆向实现，更新偶尔会带来变化。如果失效，请附上报错信息和 Codex 版本提 issue，修复通常很快。

会恢复哪些对话？

由你决定。默认不预选——勾选你在意的暂停对话，或从全部对话列表中挑选；需要批量时可用各区域「全选」。

遇到问题 / 发现 Bug？

请在 GitHub 提 issue，附上面板日志、macOS 版本与 Codex 版本。也欢迎提交 Pull Request。