Monitor Token：让 Codex Token 用量始终可见

经常使用 Codex CLI 或 Codex Desktop 时，我希望不用反复打开其他页面，就能随时看到今天用了多少 Token、周额度还剩多少、什么时候重置。

因此做了 Monitor Token：一个轻量、常驻桌面的 Codex Token 用量悬浮窗，支持 Windows 和 macOS，项目已按 MIT 协议开源。

GitHub：https://github.com/a596480606/monitor_token
下载：https://github.com/a596480606/monitor_token/releases/latest

界面预览

轻量卡片

仪表卡

极简状态条

主要功能

• 今日、本周、本月 Token 统计
• 输入、输出、缓存、推理 Token 明细
• 展示 Codex 主周额度已用百分比和重置时间
• 仪表卡、极简状态条、轻量卡片三种样式
• 普通、千分位、智能缩写、固定 M 四种数值格式
• 拖动窗口移动位置，双击立即刷新，右键完成所有配置
• 服务端额度暂时不可用时，可手动设置周 Token 额度

整个窗口会根据实际内容收缩宽度，尽量减少桌面占用。极简状态条适合长期放在屏幕边缘，仪表卡则更适合查看完整明细。

下载与平台支持

运行前需要先安装并登录 Codex CLI。

目前安装包尚未进行商业代码签名。Windows 可能出现 SmartScreen 提示；macOS 首次启动时，可以在 Finder 中右键应用并选择“打开”。请只从本项目的 GitHub Releases 下载。

数据从哪里来

Monitor Token 不抓取网页，也不要求额外填写 OpenAI API Key：

1. 增量扫描本机 ~/.codex/sessions 中新增的 Token 事件。
2. 按本地时区汇总今日、本周和本月使用量。
3. 在后台调用本机 Codex app-server 获取主周额度和重置时间。
4. 实时额度不可用时，回退到最近的本地会话快照或手动额度。

文件扫描和额度请求都放在后台线程中，不会阻塞 PySide6 界面。

隐私设计

• 所有 Token 汇总均在本机完成
• 不读取提示词或回复正文
• 不上传 Codex 会话记录
• 不接入额外的第三方统计服务

从源码运行

git clone https://github.com/a596480606/monitor_token.git
cd monitor_token
python -m venv .venv
python -m pip install -r requirements.txt
python main.py

项目使用 Python + PySide6 开发，并通过 GitHub Actions 在 Windows、Intel Mac 和 Apple Silicon Mac 上自动测试、打包和发布。

后续计划

• 系统托盘与开机启动
• 更完善的高 DPI 和无障碍适配
• Linux 桌面包
• 可选的历史趋势图
• Windows/macOS 代码签名

如果你也是 Codex 重度用户，欢迎下载试用并反馈统计准确性、界面尺寸或平台兼容问题。Issue 和 Pull Request 都欢迎；如果项目确实有帮助，也欢迎在 GitHub 点一个 Star。