by shanggqm
macOS desktop widget for OpenAI Codex usage, quota tracking, token usage, and today task board
# Add to your Claude Code skills
git clone https://github.com/shanggqm/codexUGuides for using cli tools skills like codexU.
Last scanned: 7/3/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-03T07:21:28.204Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how codexU compares with popular alternatives.
codexU is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by shanggqm. macOS desktop widget for OpenAI Codex usage, quota tracking, token usage, and today task board. It has 351 GitHub stars.
Yes. codexU passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/shanggqm/codexU" and add it to your Claude Code skills directory (see the Installation section above).
codexU is primarily written in Swift. It is open-source under shanggqm on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codexU against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

codexU v1.3.1 在 AI 领导力模型之外提供本机推理性能监测,并补齐独立 Windows x86_64 Tauri Dashboard。所有数据仍在本机处理,并与既有额度、用量和任务口径保持独立。
[!IMPORTANT] 建议升级到 v1.3.1 或更高版本。 v1.3.1 补齐 Windows x86_64 Dashboard,并包含本机推理性能监测和聚合边界修复。下载最新版本。
codexU 是一个 macOS 菜单栏与桌面应用,用来查看 OpenAI Codex / ChatGPT Codex 和 Claude Code 的额度窗口、token 用量、今日任务和本机 AI 领导力。它把常用信息放在菜单栏和主窗口里,帮助你快速判断剩余额度、重置时间、当天工作进展,以及一个人正在调动多少 AI 劳动力。
当前 Windows x86_64 桌面版本随 GitHub v1.3.1 Release 提供,并包含完整的独立 Tauri Dashboard;安装包提供 MSI 与 NSIS 两种方式:
codexU-1.3.1-windows-x86_64.msi:适合通过 Windows Installer 安装。codexU-1.3.1-windows-x86_64-setup.exe:适合通过 NSIS 安装向导安装。26200 归类的 Windows 11 环境完成;Windows 10 仍是支持目标,但未在本轮实机观测。%USERPROFILE%\.codex\ 等本机数据,保持本地优先和隐私边界,不上传 usage、线程、路径、日志或账户数据。Windows 版本是独立的 Tauri 桌面实现,当前发布包尚未由仓库默认流程进行代码签名;Windows 可能在首次运行时显示安全提示。Windows 与 macOS 的功能实现仍在分别演进,当前功能覆盖并不完全相同。





T 标签。Codex | Claude Code 全局开关,可手动切换所有面板的数据范围。Command + U 显示或隐藏主窗口,并可在设置中自定义;菜单栏 Runtime 菜单也可以快速打开主窗口、设置或退出。“羊毛进度”是 codexU 对本月 Codex 使用量的 API 等效价值估算。它把本机解析到的普通输入、cache write、命中缓存输入和输出 token,按对应模型及实际 service tier 的 OpenAI API token 单价折算成美元金额,并和 Plus、Pro 100、Pro 200 以及参考月上限做对比。这个指标解决的问题是:Codex 额度本身通常只显示百分比和重置时间,token 数量也不容易直观看出“用了多少价值”;羊毛进度提供一个统一的金额口径,帮助你判断本月订阅成本大致回收到了哪个区间。
单次 token 用量的估算公式为:
API 等效价值 =
普通未缓存输入 tokens / 1,000,000 * 模型输入单价
+ cache write tokens / 1,000,000 * 模型 cache write 单价
+ 缓存输入 tokens / 1,000,000 * 模型缓存输入单价
+ 输出 tokens / 1,000,000 * 模型输出单价
其中 cache write 和缓存命中都按不超过输入 tokens 的数量计入,避免重复计价。解析到 service_tier = priority/fast 时使用官方 Fast mode API 单价;支持长上下文计价的模型在单次输入超过 272K tokens 时使用官方长上下文单价。推理强度不会被额外乘一次,因为 reasoning tokens 已包含在输出 token 中。价格来源以 OpenAI 的实时 API 定价页和对应模型页为准。
本月羊毛进度会累计当月所有本机 session 的 API 等效价值。GPT-5.3-Codex-Spark 仍是 research preview,官方尚未公布最终费率;这类模型及未知模型继续按 GPT-5.5 参考价折算,并用 ≈ 明确标记为参考估算,而不会冒充官方价格。进度条的参考终点使用 2 亿 tokens/天 * 30 天 估算,并按 30% 未缓存输入、50% 缓存输入、20% 输出的参考 token mix 折算;当前参考价约为 $7.75 / 1M tokens,参考月上限约 $46,500。进度条采用分段非线性刻度:Plus / Pro 节点保留在前段,超过 Pro 200 后用对数比例映射到参考终点,因此条宽用于扫视阶段进展,不等同于线性美元占比。该金额只是基于 API 价格的等效估算,不代表实际账单或官方返现金额。
Command + U:默认用于显示或隐藏主窗口,可在设置中自定义;如果窗口已最小化,会恢复并唤到前台。codexU 目前通过 GitHub Release 的 DMG 安装包分发,不经过 Mac App Store。第一次打开时,macOS 可能会拦截,需要手动允许:
codexU.app 一次。如果系统提示无法打开,先取消弹窗。codexU.app,点击 仍要打开。也可以在 Finder 中右键点击 codexU.app,选择 打开,再确认系统安全提示。
codexU 需要读取本机 ~/.codex/ 下的 Codex 数据;如果启用 Claude Code 统计,还会读取 ~/.claude/ 下的本机 transcript、任务和状态缓存。如果 macOS 弹出文件或文件夹访问授权,请允许访问,否则小组件无法读取本机 usage、线程和自动化任务信息。
从 GitHub Release 下载与你的 Mac 芯片匹配的安装包:
codexU-<version>-mac-arm64.dmgcodexU-<version>-mac-x86_64.dmgcodexU.app 拖到 Applications 文件夹。Applications 打开 codexU。安装后,codexU 默认每天最多自动检查一次 GitHub Release 是否有新版本,并接收 beta 版本。该检查只读取公开 Release 元数据;发现新版时会打开浏览器下载 DMG 或查看 Release 页面,安装仍由你手动完成。可以在设置窗口的系统区关闭自动检查,或手动点击“检查更新”。
从 GitHub Release 下载 Windows x86_64 安装包:
codexU-<version>-windows-x86_64.msicodexU-<version>-windows-x86_64-setup.exe运行安装程序并按向导完成安装。每个安装包旁边都提供对应的 .sha256 校验文件;发布包的构建、校验和当前限制见 DISTRIBUTION.md。
~/.codex/state_5.sqlite。~/.claude/projects/**/*.jsonl,额度需要本地 statusLine snapshot cache。%USERPROFILE%\.codex\ 下的本机数据。make build
运行:
make run
安装到 /Applications:
make install
检查本机数据源输出:
make probe
make release
make release 会按当前构建机器的架构输出安装包。也可以显式打包指定架构:
make release-arm64
make release-intel
make release-all
产物会写入 dist/,例如:
dist/codexU-1.3.1-mac-arm64.dmg
dist/codexU-1.3.1-mac-arm64.dmg.sha256
dist/codexU-1.3.1-mac-x86_64.dmg
dist/codexU-1.3.1-mac-x86_64.dmg.sha256
Developer ID 签名和 Apple notarization 流程见 DISTRIBUTION.md。
codex app-server 的 account/read、account/rateLimits/read、account/usage/read。~/.codex/state_5.sqlite。~/.codex/sessions/**/rollout-*.jsonl 和 ~/.codex/archived_sessions/*.jsonl 中的 token_count 事件。model、reasoning_effort 和增量输出 token 的完整模型调用,排除低于 100ms 的时间戳噪声后,按模型与推理强度聚合今日、7 日、28 日的 P50、P90、平均调用耗时和有效吞吐。去重样本有界保存在 ~/Library/Application Support/codexU/inference-performance-v1.json,即使原 rollout 后续移出线程列表也可继续进入滚动窗口;不保存 prompt、回复或路径,也不把该口径标为 TTFT 或可见文本解码 TPS。token_count 事件聚合;模型曲线优先按同一 session 中、位于 token 事件之前最近的 turn_context.model 归因。该 turn context 未记录模型时不会沿用上一轮,而是回退到线程模型。缺失精细事件时,日归因整体回退到线程更新时间的粗略口径;模型面积图在 Codex runtime 中按 Top 8 + 其他模型展示,并叠加全局总用量虚线,费用口径始终是本地 API 等效估算。Claude Code 暂不提供模型归因或模型面积图。~/.codex/automations/**/automation.toml 中启用的 automation 元数据;周期、时区和时间足够明确时在本机计算下次运行,规则不完整时不猜测。