Codex Reset

Codex Reset 是一款面向 macOS 的开源菜单栏小工具，专门解决 OpenAI Codex 桌面应用用量限额（5 小时滚动窗口）带来的频繁中断问题。当 Codex 因达到用量上限而暂停对话时，用户通常需要等待数小时并在恢复后手动输入「继续」来恢复任务。Codex Reset 自动监控用量窗口重置时间，一旦检测到可用额度恢复，立即向用户已勾选的暂停对话发送「继续」指令，让后台任务真正实现无人值守。

项目简介

OpenAI Codex 桌面应用为编程任务提供强大的 AI 辅助能力，但其用量限制机制对于长时间运行的多项目开发造成不便：当 5 小时滚动窗口耗尽时，所有进行中的对话会被强制暂停，屏幕上弹出「升级计划或等待重置」的提示，用户必须手动切换到每个对话输入「继续」才能恢复。Codex Reset 通过监听本地 Codex 实例的用量状态，在窗口重置瞬间自动完成这一重复操作，支持同时管理多个项目和对话线程。

核心功能

实时用量监控与倒计时。菜单栏实时显示当前 5 小时窗口用量进度条、1 周窗口状态、下一次重置倒计时、当前计划类型和额度余额，所有关键信息一目了然。

自动恢复对话。当 5 小时窗口重置时，Codex Reset 自动向用户预先勾选的暂停对话发送「继续」指令（或其他自定义命令），无需人工干预。用户可选择全部勾选或针对特定对话逐个控制。

对话浏览与项目分组。所有项目和对话按项目分组列出（已归档和子代理线程自动过滤），支持查看任意对话状态，包括尚未暂停的对话，用户可提前将其纳入恢复队列。

双击跳转deep link。双击任意对话条目直接通过 Codex deep link 跳转到对应对话界面，在 Codex 应用中快速定位。

用量历史时间线。每次 5 小时窗口重置都会自动记录，用户可以查看每天用量恢复的确切时间规律，便于安排工作节奏。

自动检测暂停对话。Codex Reset 自动发现因用量限额（usageLimitExceeded）而暂停的对话，并在每个条目上显示预计恢复时间。

命令行模式。支持 --query 查询用量、--continue 从终端恢复指定线程，适合 CI 环境和自动化脚本集成。

技术实现

Codex Reset 采用两层通信机制保障恢复指令的可靠送达：

本地应用服务器模式（首选）。通过 Codex 捆绑的本地 app-server（remote_control 或私有实例模式）通信，直接在新的对话轮次中注入用户指定命令。无需辅助功能权限，响应最可靠。

GUI 后备模式。当 Codex 桌面应用持有当前对话时，通过 deep link 跳转到 Codex，将输入框聚焦，粘贴命令文本，以快捷键 ⌘Enter 发送。此模式需要 macOS 辅助功能权限。

技术栈方面，Codex Reset 是一款原生 macOS 菜单栏应用，使用 Xcode 构建，依赖 Xcode 命令行工具。应用仅与用户本地机器上的 Codex 实例通信，不连接任何外部服务器，隐私安全。

快速上手

第一步，安装 Codex 桌面应用。从 openai.com/codex 下载并安装 Codex 桌面版，这是配套工具而非独立产品。

第二步，构建 Codex Reset。确保系统已安装 Xcode 命令行工具，运行 git clone 或直接下载 Release 包进行构建。

第三步，运行并授权。启动 Codex Reset 后，根据提示授权辅助功能权限（如使用 GUI 后备模式）。在菜单栏图标上查看实时用量状态。

第四步，勾选需要恢复的对话。当对话因用量限额暂停时，在 Codex Reset 列表中勾选需要自动恢复的对话，设置自动恢复规则。

第五步，自动化运行。设置完成后，Codex Reset 在后台静默运行，用量窗口重置时自动发送「继续」指令，用户可安心离开电脑。

适用人群

同时运行多个 Codex 项目或代理线程的开发者，需要长时间后台运行 AI 编码任务而不希望频繁手动恢复的用户，以及对 Codex 用量管理有精细化需求的高级用户。

开源与社区

Codex Reset 由独立开发者 boyso 创建和维护，为非官方开源工具，代码可在 GitHub 公开查阅，欢迎提交 Issues 和 Pull Requests 共同改进。