Codex Gauge

一个轻量的 Codex CLI 额度监控桌面应用。界面使用 Svelte 5，桌面壳使用 Tauri 2，额度采集与解析完全在 Rust 侧完成。

工作方式

应用启动 Codex app-server，通过结构化的 account/rateLimits/read 协议读取 5 小时额度、周额度和精确重置时间。采集完成后会立即结束 app-server，不会启动对话或向模型发送提示词。

窗口操作

• 应用常驻系统托盘，不会显示在任务栏中；点击最小化按钮后可通过左键单击托盘图标恢复。
• 右键单击托盘图标可显示窗口或退出应用，窗口右上角的关闭按钮会直接退出。
• 将窗口拖到或越过当前屏幕工作区的上边、左边或右边，它会收起为两根额度进度条；鼠标移入时临时展开，移出后立即再次收起。从展开窗口的标题栏拖动可解除停靠。

开发

需要 Node.js 20+、Rust stable、Codex CLI，以及 Windows 上的 Microsoft C++ Build Tools 和 WebView2。

使用 VS Code 打开项目后，可直接点击“运行和调试”中的“运行 Codex Gauge（Debug）”（或按 F5）。VS Code 会启动前端开发服务器、编译 Debug 版本并运行 src-tauri/target/debug/codex-gauge.exe。

npm install
npm run check
npm run tauri dev

首次使用前，请先在普通终端中完成 Codex 登录：

codex login
codex

测试

npm run check
npm run build
cargo test --manifest-path src-tauri/Cargo.toml

一键打包 Portable EXE

Windows 下双击项目根目录的 build-exe.cmd。脚本会检查 Node.js、Rust 和 MSVC，运行项目检查，并生成无需安装、可直接运行的 EXE：

artifacts\CodexGauge-0.1.0-Portable.exe

目标电脑仍需安装 Microsoft Edge WebView2 Runtime，并已安装、登录 Codex CLI。

在终端或 CI 中运行时可跳过结束暂停：

.\build-exe.cmd --no-pause