最近用 Codex CLI 的频率越来越高，但也遇到了几个很现实的小问题：

• 额度还剩多少、什么时候重置，不想每次都打开终端查看；
• 之前的会话多了以后，想找某一次讨论过的内容不太方便；
• 换电脑时，希望能把重要的对话记录带过去；
• 出现“读不到额度”时，不知道是 CLI 没装、没登录，还是本地服务连接异常。

所以我做了一个桌面端小工具：Codex Desk。

它不是用来替代 Codex CLI 的，而是作为一个本地桌面控制台，帮助更直观地查看额度、管理会话。

这次重点优化了额度悬浮球、个人中心和会话详情阅读体验：查看额度窗口更直观，翻找长会话也更舒服。

它能做什么？

1. 桌面悬浮查看额度

启动后，桌面会显示一个小型悬浮额度球，点击即可展开看板。

悬浮球会直接标识当前额度窗口：有短周期额度时显示“5 小时”，没有短周期额度时会显示“7 天”。展开后可以看到各额度窗口的剩余比例、已使用比例和下次重置时间。平时不用反复切到终端，抬眼就能知道当前状态。

当额度达到 80%、90%、100% 时，也可以选择开启系统通知提醒。每个额度窗口内同一个阈值只提醒一次，避免频繁打扰。

2. 查看个人中心

右上角的个人中心可以按需显示当前登录邮箱、订阅方案和登录方式，方便确认当前桌面工具连接的是哪个 Codex 账号。

这里只展示必要的账户元数据，不展示认证令牌或其他敏感凭据。

3. 查看最近 7 天使用趋势

除了当前额度，Codex Desk 还会把最近 7 天的使用情况做成趋势图。

目前支持查看四个维度：

• 消息数量
• 工具调用次数
• 文件变更数量
• 异常数量

当自己一段时间内使用频率明显升高，或者某个项目里工具调用、文件变更异常多时，可以更快发现情况。

4. 浏览、搜索本地会话

工具会读取本机的非归档 Codex 会话，支持按会话标题或会话 ID 模糊搜索。

点击某个会话后，会进入左右分栏的详情页：左侧集中展示会话标题、最后更新时间、消息数、工具调用数、文件变更数、异常数，以及可滚动的近期操作；右侧专注阅读用户消息和 Codex 回复。

详情页支持在当前会话内按关键词搜索消息。输入关键词后，可通过 Enter 跳到下一条匹配内容，Shift + Enter 跳到上一条，长会话不必再手动下翻查找。

5. 导入、导出会话

如果有跨设备迁移或备份需求，可以选择单个会话、当前页会话，或者搜索结果中的全部会话进行导出。

导出的内容是可移植的会话文本包；在另一台已经登录 Codex CLI 的电脑上导入后，会创建新的本地会话。

这里需要说明一下：它导出的是对话文本，不是 Codex 运行环境的完整备份；导出文件是未加密 JSON，建议不要上传到不可信的位置。

6. 提供本地诊断

首次使用时，如果没有读取到额度，可以点击右上角的“诊断 Codex CLI”。

它会检查本机是否安装了 Codex CLI、app-server 是否可用，以及额度读取是否正常。这样遇到环境问题时，至少能比较快定位大致原因。

隐私方面怎么处理？

这是我比较在意的一点。

Codex Desk 不会把会话、额度或认证信息上传到额外的第三方服务。会话、额度和个人中心信息都通过本机已登录的 Codex CLI 获取：

codex app-server --stdio

它不读取或保存 auth.json，也不会主动刷新令牌。打开个人中心时，只会按需读取邮箱、订阅方案和登录方式等展示所需元数据；会话数据、额度信息和账户展示信息都只在本机使用。

如何使用？

首先需要单独安装并登录 Codex CLI：

npm install -g @openai/codex
codex

完成登录后，前往项目的 Releases 页面下载对应系统的安装包即可：

下载地址

目前提供 Windows、macOS 和 Linux 的构建产物。

写在最后

这个项目最初只是想解决自己查看额度和翻找历史会话的麻烦，后面逐渐补充了趋势分析、额度提醒、会话迁移和本地诊断等功能，也会继续把重点放在“少占屏、好查找、易阅读”上。

如果你也经常使用 Codex CLI，欢迎试试。遇到问题或有功能建议，也欢迎在 GitHub 提 Issue。

项目地址再放一次：Codex Desk

如果觉得有帮助，帮忙点个 Star 就更好了。