← Back
jaykinhoo9

jaykinhoo9/codex-usage-badge

Codex desktop quota rings, project folder colors and per-chat Token indicators for macOS and Windows.

View on GitHub ↗
Stars
41
Forks
3
Watchers
41
Open issues
2
Contributors
1
Language
JavaScript
License
MIT License
Default branch
main
Created Sep 27, 2026Updated Sep 30, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Codex Usage Badge · Codex 用量条

为 Codex 桌面端增加额度显示、项目配色、文件夹容量和会话 Token 统计，适配浅色与深色主题。

Codex Usage Badge：原生风格额度圆环、项目配色与 Token 色块

功能

  • 额度圆环：查看订阅剩余额度，绿、黄、红对应充足、偏低和即将耗尽。Plus 支持 5 小时与每周额度双圆环。
  • 文件夹配色：在项目菜单中选择颜色，方便区分不同项目。
  • 文件夹容量（macOS）：在本地项目名称旁显示目录占用，支持 KB、MB、GB 等单位，自动缓存并刷新。
  • 会话 Token：用蓝色色块表示用量，悬停查看累计 Token，按万、千万、亿显示。
  • 自动更新（macOS）：每 6 小时检查 GitHub Releases，校验安装包后在后台升级，失败时恢复原版。

下载

macOS v0.9.4 预发布版 · Windows v0.10.1

系统 安装包 使用说明
macOS · Apple Silicon / Intel 下载 ZIP macOS 安装
Windows 10 / 11 下载 ZIP Windows 安装

macOS 和 Windows 安装后均可沿用原应用图标，启动时自动加载。Windows 后台在新窗口尚未开始操作时请求正常重开；点击、输入或后台启动时会跳过。需要已登录的 Codex 客户端和 Node.js 24+，安装器会优先查找客户端自带的运行环境。

更新记录 · 问题反馈 · 开发说明 · 隐私与安全

Windows v0.10.1 起默认从 GitHub Release 自动更新，可通过 Update.cmd 立即检查。旧版本需先手动升级一次；之后发布更高版本的 Windows 安装包和校验清单即可自动分发。更新设置与发布方式

非官方项目，与 OpenAI 无关联。采用 MIT 许可。