CodexTray
A lightweight Windows floating quota monitor for OpenAI Codex.
CodexTray 是一个运行在 Windows 上的 Codex 用量悬浮窗工具，用来显示主额度、刷新时间和周额度状态，并通过系统托盘常驻桌面。
功能
- 显示 Codex 主额度百分比
- 显示主额度刷新时间
- 显示周额度可视化方块
- 显示周额度刷新日期
- 支持折叠与展开
- 支持桌面悬浮
- 支持系统托盘菜单
- 支持在线状态显示
- 支持手动重连
- 自动连接本机 Codex app-server
环境要求
- Windows 10 / Windows 11
- OpenAI Codex CLI
- Node.js LTS（仅源码运行需要）
普通用户使用
普通用户建议直接下载 GitHub Releases 中的 CodexTray.exe。
普通用户不需要安装 Node.js 或 Electron，但必须先安装并登录 Codex，确保本机可以启动或连接 Codex app-server。
开发者运行
npm install
npm run dev
构建
npm run build
npm run build:portable
常见问题
程序显示离线
通常表示当前无法连接或无法读取本机 Codex 状态。先确认 Codex CLI 已安装，且 Codex 已完成登录。
Codex CLI 未安装
请先安装 OpenAI Codex CLI，再启动本程序。
Codex 未登录
如果 Codex 未登录，程序可能无法读取额度信息。请先在本机完成 Codex 登录。
当前目录未信任
部分 Codex 行为依赖当前工作目录状态。如果 Codex CLI 本身提示目录未信任，请先在 Codex 中处理该问题。
端口不是固定的 48888
程序默认优先尝试本地 48888，但会根据实际情况复用已存在的 Codex app-server，或由 Codex CLI 拉起新的本地服务。
点击重连后的行为
点击“重连”会尝试重新连接本机 Codex app-server，并刷新当前额度信息。
Windows Script Host 拦截 VBS
如果系统禁止 .vbs，建议直接运行 CodexTray.exe 或 Start-CodexTray.bat。
推荐直接运行 EXE 或 BAT
日常使用建议直接运行打包后的 CodexTray.exe；开发调试可以运行 Start-CodexTray.bat 或 npm run dev。
隐私说明
- 程序只连接本机 Codex app-server
- 不上传用户代码
- 不保存 API Key
- 不应在仓库中提交认证文件、
auth.json、Token 或其他本机凭据
License
MIT License
