Topics

#chatgpt #codex #codex-cli #dashboard #desktop-widget #developer-tools #local-first #macos #macos-app #menu-bar-app #openai #openai-codex #quota-tracker #rate-limit #swift #swiftui #token-usage #usage-tracker

Language breakdown

No language data available.

▸ Files click to expand

README

codexU

[!IMPORTANT]

建议升级到 v1.0.1 或更高版本。 Codex 与 ChatGPT 合并升级后，macOS 应用由 Codex.app 更名为 ChatGPT.app。旧版 codexU 仍按旧路径查找 Codex，可能导致额度和用量读取失败；v1.0.1 已兼容新应用名称，并保留旧版路径与标准 CLI 回退。下载最新版本。

English

codexU 是一个 macOS 菜单栏与桌面应用，用来查看 OpenAI Codex / ChatGPT Codex 和 Claude Code 的额度窗口、token 用量和今日任务状态。它把常用信息放在菜单栏和主窗口里，帮助你快速判断剩余额度、重置时间和当天工作进展。

界面截图

codexU v1.0.2 状态栏定制与主界面

codexU 今日任务视图

codexU 用量趋势视图

codexU 项目排行视图

codexU Skill 使用视图

适合谁

经常使用 OpenAI Codex、Codex CLI 或 Codex 桌面应用的开发者。
同时使用 Codex 和 Claude Code 做开发，希望在一个入口查看两边本机用量的人。
需要快速查看 5 小时/7 天额度、token 用量和重置时间的 ChatGPT Pro / Team 用户。
想在桌面查看 Codex 使用状态、减少反复打开浏览器或终端的人。

功能

展示 Codex 5 小时和 7 天额度的剩余比例、已用比例和重置时间。
新增状态栏 Runtime 菜单：点击菜单栏图标后先展示 Codex / Claude Code 卡片、5 小时和 7 日剩余、今日 token 与总 token。
状态栏支持简约、经典、丰富三档透明显示：简约只保留加粗的 5h/7d 同心双环，经典的独立进度环内只保留额度数字，丰富展示完整标签、进度条和重置时间。
状态栏额度可切换“已用量 / 剩余量”口径，并可选择显示 5 小时、7 天、今日 token 和重置倒计时；5h/7d 进度色与主界面蓝紫双环一致。
状态栏用进度方向区分口径：已用为顺时针/左到右，剩余为逆时针/右到左，不额外占用文字空间。
状态栏 Runtime 使用从原始 Logo 精确派生的单色模板，文字与图标按菜单栏实际深浅自动切换黑白；彩色品牌图标继续用于主窗口和浮窗。
今日总 token 在状态栏中只显示垂直居中的总量数字，不增加 T 标签。
今日总量使用系统菜单栏正文尺寸；5h/7d 标签与重置时间使用更易读、仍弱于主数值的动态辅助前景色。
主界面顶部新增 Codex | Claude Code 全局开关，可手动切换所有面板的数据范围。
支持 Claude Code 本机 transcript 用量统计、最近 7 日趋势、项目排行、工具/Skill TOP 和任务看板基础能力。
汇总今日、近 7 天和累计 token 用量，并细分未缓存输入、命中缓存输入和输出。
按 OpenAI API token 价格估算本月 API 等效价值，并在 Plus、Pro 100、Pro 200 和满额月价值之间展示进度刻度。
下方仪表盘支持今日任务、用量趋势、项目排行和 Skill 使用视图。
从本机 Codex 线程和启用中的 automations 生成今日任务看板，按进行中、待处理、定时、完成四类组织任务。
展示最近半年的每日 token 热力图、最近 7 日趋势摘要和同周期变化。
展示最近 7 天与全部项目排行，包含 token、估算价值、线程数和最近活跃时间。
展示工具调用 TOP 列表和 Skill 使用 TOP 列表，帮助判断本地 Codex 工作结构。
以标准 macOS 窗口运行，支持 Dock、系统窗口控制、最小化和关闭主窗口后继续后台运行；关闭主窗口会隐藏 Dock 图标并保留菜单栏图标。
支持 Command + U 显示或隐藏主窗口；菜单栏 Runtime 菜单也可以快速打开主窗口、设置或退出。
设置窗口支持中文/英文界面、自动/浅色/深色外观、状态栏内容与实时预览、主窗口置顶、关闭行为、系统状态和更新检查配置。
默认自动检查 GitHub Release 新版本并接收 beta 版本，发现新版时提供匹配当前 Mac 架构的 DMG 下载入口；不会静默下载安装，自动检查可关闭。
本地读取数据，不上传 usage、线程或账户数据到第三方服务。

羊毛进度

“羊毛进度”是 codexU 对本月 Codex 使用量的 API 等效价值估算。它把本机解析到的未缓存输入、命中缓存输入和输出 token，按对应模型的 OpenAI API token 单价折算成美元金额，并和 Plus、Pro 100、Pro 200 以及满额月价值做对比。这个指标解决的问题是：Codex 额度本身通常只显示百分比和重置时间，token 数量也不容易直观看出“用了多少价值”；羊毛进度提供一个统一的金额口径，帮助你判断本月订阅成本大致回收到了哪个区间。

单次 token 用量的估算公式为：

API 等效价值 =
  未缓存输入 tokens / 1,000,000 * 模型未缓存输入单价
缓存输入 tokens / 1,000,000 * 模型缓存输入单价
输出 tokens / 1,000,000 * 模型输出单价

其中 未缓存输入 tokens = 输入 tokens - 缓存输入 tokens，缓存输入按不超过输入 tokens 的数量计入。本月羊毛进度会累计当月所有本机 session 的 API 等效价值。进度条的满额终点使用 2 亿 tokens/天 * 30 天 估算，并按 30% 未缓存输入、50% 缓存输入、20% 输出的参考 token mix 折算；当前参考价约为 $7.75 / 1M tokens，满额月价值约 $46,500。进度条采用分段非线性刻度：Plus / Pro 节点保留在前段，超过 Pro 200 后用对数比例映射到满额终点，因此条宽用于扫视阶段进展，不等同于线性美元占比。该金额只是基于 API 价格的等效估算，不代表实际账单或官方返现金额。

快捷键和操作

Command + U：显示或隐藏主窗口；如果窗口已最小化，会恢复并唤到前台。
菜单栏仪表图标：点击后打开 Runtime 菜单；点击 Codex 或 Claude Code 卡片会打开主界面并切到对应 Runtime。
菜单栏 Runtime 菜单：展示 Codex / Claude Code 快速状态，并提供打开主窗口、打开设置和退出。
设置窗口：配置语言、外观、状态栏展示模式/额度口径/可见指标、主窗口置顶及关闭行为，并在系统区控制自动检查、查看状态或手动检查 GitHub Release 更新。
主窗口顶部刷新按钮：立即刷新额度、token 统计、趋势图和任务看板。
系统红黄绿窗口按钮：关闭、最小化或缩放主窗口；关闭后可通过菜单栏图标或快捷键唤回，退出请使用菜单栏 Runtime 菜单或 App 菜单。

首次安装：隐私与安全

codexU 目前通过 GitHub Release 的 DMG 安装包分发，不经过 Mac App Store。第一次打开时，macOS 可能会拦截，需要手动允许：

打开 codexU.app 一次。如果系统提示无法打开，先取消弹窗。
打开 系统设置 > 隐私与安全性。
在 安全性 区域找到 codexU.app，点击 仍要打开。
使用 Touch ID 或密码确认，然后点击打开。

也可以在 Finder 中右键点击 codexU.app，选择打开，再确认系统安全提示。

codexU 需要读取本机 ~/.codex/ 下的 Codex 数据；如果启用 Claude Code 统计，还会读取 ~/.claude/ 下的本机 transcript、任务和状态缓存。如果 macOS 弹出文件或文件夹访问授权，请允许访问，否则小组件无法读取本机 usage、线程和自动化任务信息。

安装

从 GitHub Release 下载与你的 Mac 芯片匹配的安装包：

Apple Silicon：codexU-<version>-mac-arm64.dmg
Intel：codexU-<version>-mac-x86_64.dmg

打开 DMG。
将 codexU.app 拖到 Applications 文件夹。
从 Applications 打开 codexU。
按上面的 首次安装：隐私与安全 步骤完成手动放行。

安装后，codexU 默认每天最多自动检查一次 GitHub Release 是否有新版本，并接收 beta 版本。该检查只读取公开 Release 元数据；发现新版时会打开浏览器下载 DMG 或查看 Release 页面，安装仍由你手动完成。可以在设置窗口的系统区关闭自动检查，或手动点击“检查更新”。

运行要求

macOS 14 或更新版本。
本机已安装 Codex。
已登录 Codex 账户，额度信息才会显示。
Codex 至少使用过一次，以便生成 ~/.codex/state_5.sqlite。
Claude Code 统计为可选能力；历史 token 来自 ~/.claude/projects/*/.jsonl，额度需要本地 statusLine snapshot cache。
从源码构建时需要 Xcode Command Line Tools。

从源码构建

make build

运行：

make run

安装到 /Applications：

make install

检查本机数据源输出：

make probe

打包 DMG

make release

make release 会按当前构建机器的架构输出安装包。也可以显式打包指定架构：

make release-arm64
make release-intel
make release-all

产物会写入 dist/，例如：

dist/codexU-1.0.2-mac-arm64.dmg
dist/codexU-1.0.2-mac-arm64.dmg.sha256
dist/codexU-1.0.2-mac-x86_64.dmg
dist/codexU-1.0.2-mac-x86_64.dmg.sha256

Developer ID 签名和 Apple notarization 流程见 DISTRIBUTION.md。

数据来源

账户与额度：codex app-server 的 account/read、account/rateLimits/read、account/usage/read。
本机 token 总量：~/.codex/state_5.sqlite。
精细 token 拆分：~/.codex/sessions/*/rollout-.jsonl 和 ~/.codex/archivedsessions/*.jsonl 中的 tokencount 事件。
今日任务看板：本机 SQLite 中未归档和今日归档的 Codex 线程。
用量趋势和项目排行：本机 session token_count 事件聚合；缺失精细事件时回退到线程更新时间的粗略口径。
工具和 Skill 使用：本机 session 事件中的工具调用与 Skill 加载记录。
定时任务：~/.codex/automations/**/automation.toml 中启用的 automation 元数据。
Claude Code 历史 token：~/.claude/projects/*/.jsonl 中 assistant message 的 message.usage 字段。
Claude Code 工具、Skill 和任务：transcript 中的 tool_use.name / 显式 Skill attribution，以及 ~/.claude/tasks/*/.json。
Claude Code active 额度：可选读取 ~/Library/Caches/codexU/claude-code/statusline-snapshot.json；缺失时 5 小时/7 日额度显示为 --。
更新检测：默认访问 GitHub Releases API，读取 shanggqm/codexU 的公开 release 元数据，并把检查结果缓存到 ~/Library/Caches/codexU/update-check.json。