最近用 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 CLInpm install-g openai/codex codex完成登录后前往项目的 Releases 页面下载对应系统的安装包即可下载地址目前提供 Windows、macOS 和 Linux 的构建产物。写在最后这个项目最初只是想解决自己查看额度和翻找历史会话的麻烦后面逐渐补充了趋势分析、额度提醒、会话迁移和本地诊断等功能也会继续把重点放在“少占屏、好查找、易阅读”上。如果你也经常使用 Codex CLI欢迎试试。遇到问题或有功能建议也欢迎在 GitHub 提 Issue。项目地址再放一次Codex Desk如果觉得有帮助帮忙点个 Star 就更好了。