shanggqm/codexU

codexU – 本地 AI 使用仪表板与领导力评分

简介

• 这是一款原生的 macOS（菜单栏 + 桌面）与 Windows x86_64 应用程序，可读取由 OpenAI Codex（以及可用的 Claude Code）创建的本地数据文件，并为您显示实时配额、Token 使用量、任务状态以及专有的 AI 领导力 评分。
• 所有处理均在本地机器上进行；不会将任何使用情况、线程、路径或账户数据发送到任何外部服务。

主要功能

功能	说明
配额概览	Codex 5 小时与 7 天窗口的剩余百分比与重置时间（若 macOS 上有 Claude Code 亦可显示）。
Token 统计	每日、7 天与累计 Token 数量，细分为缓存写入、缓存命中与输出 Token。
AI 领导力评分	0-100 的评级（七个徽章等级），源自本地可验证的代理生命周期、父子关系、并发性与自主执行证据，而非仅基于原始 Token 数量。
任务看板	列出今日的 Codex/Claude 任务，包含状态、工作区、时间戳与下次自动化执行时间。
使用趋势	每日 Token 使用热图、模型面积图（前 8 大模型 + “其他”）以及以美元计算的预估 API 等效成本。
项目与工具排名	显示哪些项目、工具与 “Skills” 消耗最多的 Token/线程。
自定义 UI 主题	六种内置配色方案（例如：“青花瓷”、“敦煌飞天”）加上社区认可的配色，皆可在 “Liquid Glass” 画廊中预览。
菜单栏小工具	紧凑的运行时视图，具备三种透明度模式（极简、经典、丰富），可显示使用量、剩余配额或两者皆显示。
跨平台	macOS 13+ (Apple Silicon 与 Intel) 与 Windows 10/11 x86_64 构建（通过 Tauri）。
隐私优先更新	自动检查 GitHub 新版本（可选），不会在后台静默下载或安装任何内容。

运作方式

• 读取 ~/.codex/ (macOS) 或 %USERPROFILE%\.codex\ (Windows) 中的 SQLite 使用数据库、rollout JSONL 文件与自动化 TOML 文件。
• 安装 Claude Code 时，亦会读取 ~/.claude/ 的 transcript JSONL 文件与任务 JSON 文件。
• 聚合 Token 事件、推断模型归属、使用当前的 OpenAI 定价页面计算成本估算，并将数据输入 UI。
• 领导力评分由内置的 ScoreModel v1.3 计算，仅计算可验证的代理生命周期与并发证据。

安装

• macOS: 从最新的 GitHub 发布页面下载对应的 DMG (codexU-<version>-mac-arm64.dmg 或 -mac-x86_64.dmg)，将 codexU.app 拖曳至 应用程序，并在首次启动时于 系统设置 → 隐私与安全性 中允许该应用程序。
• Windows: 下载 MSI 或 NSIS 安装程序 (codexU-<version>-windows-x86_64.msi / .exe)，运行并依照向导指示操作。Windows 版本目前仅支持 Codex 数据。
• 从源码构建: make build (macOS 需 Xcode 命令行工具)。使用 make run、make install 或 make release 来生成 DMG/安装程序包。

基本使用

• 按下 ⌘ + U (或设置的快捷键) 来切换主窗口。
• 菜单栏图标可开启 Runtime 菜单，您可以在此切换 Codex 与 Claude 视图、开启设置或退出。
• 设置允许您选择语言、外观（亮色/暗色/自动）、菜单栏显示的指标，以及是否自动检查更新。
• AI Leadership 面板显示徽章、进度环以及过去 28 天的四项核心指标（代理、AI 时数、峰值并发、评分）。

适用对象

• 定期使用 Codex (或 Codex CLI) 并希望快速查看剩余配额与 Token 消耗的开发者。
• 同时执行 Claude Code 并需要单一窗口管理两项服务的团队。
• 任何使用 ChatGPT Pro/Team 方案且希望在不开启浏览器的情况下监控每日/每周使用量的用户。

授权

• MIT License (参阅 LICENSE)。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。