codex-stats Skill 技能

技能简介

codex-stats 是一款本地优先的 AI 编程 Agent 用量分析仪表盘。它直接读取本机上各编码助手留下的会话数据，汇总成一个可分享的浏览器仪表盘：总览页合并展示所有工具，Codex、OpenCode、Claude Code、Hermes 各有独立标签页，支持日/周/月/全时间窗口、模型与项目维度拆分、成本估算、分支级花费排行、厂商归属与工具行为分析。它不代理也不拦截任何 API 流量，只解析本地文件，所有数据留在你的机器上。

核心能力

• 四工具统一看板：Codex（~/.codex 的 sqlite + rollout 文件）、OpenCode、Claude Code（~/.claude/projects/**/*.jsonl）、Hermes 各自成页，总览页合并对比；没数据的工具显示空态而非隐藏。
• 多时间窗口与拆分：每个标签页内可切日/周/月/全时间，查看模型维度、项目维度与最近会话历史。
• 成本与 Token 分析：按模型名估算 Token 成本（工具自己记录了成本就用其记录），支持每工具成本覆盖、Thinking Token 占比统计，以及按厂商归属的花费拆解。
• 分支级花费面板：把花费按 git 分支而非仓库排行，并标出「沉默分支」——花了 Token 却停更 14 天没做完的工作，在项目级视图里这类浪费通常看不见。
• 工具行为追踪：归一化为 Read、Edit、Execute、Search、Web、Subagent、Plan 等共享类别，展示各 Agent 实际调用的工具、失败率、重复调用检测、读写比例与弃轮次数。
• 文件级影响统计：项目下钻页给出「本项目改得最多的文件」，含编辑次数与增删行数（解析 Codex 与 Claude Code 的 rollout）。
• 分享与导出：仪表盘可打印为 PDF，也可下载摘要、成本、专注度、项目占比的 JPG 卡片。

安装配置

1. 推荐安装：pipx install codex-stats；或 python3 -m pip install codex-stats。
2. 数据源就绪：无需额外配置，工具会读取本机默认位置的四套数据；无数据的工具照样占一个标签页。
3. 路径覆盖：用 CODEX_HOME、CODEX_STATS_OPENCODE_HOME、CODEX_STATS_CLAUDE_PROJECTS_DIR、CODEX_STATS_HERMES_HOME 指向非默认目录。
4. 读取范围：默认每个数据源只读最近 2000 个会话以保证启动可预期；CODEX_STATS_MAX_SESSIONS=0 可读全量获取精确数值。

使用步骤

1. 安装：执行 pipx install codex-stats（或 pip 安装）。
2. 启动：运行唯一命令 codex-stats，无任何必填参数。
3. 查看仪表盘：工具会生成 ~/.cache/codex-stats/dashboard.html 并在默认浏览器打开；路径固定，可加书签，每次运行覆盖旧文件并带时间戳，刷新即见最新一次结果。
4. 切换视图：在页面顶部用 Overview / Codex / OpenCode / Claude Code / Hermes 标签切换，再用 Day / Week / Month / All Time 切窗口。
5. 导出分享：把当前工具与窗口打印为 PDF，或下载 JPG 卡片分享给同事。

适用场景

• AI 编程开销复盘：想知道这个月在 Claude Code 与 Codex 上各烧了多少 Token、多少钱。
• 浪费定位：按分支找出了花钱却没做完的沉默分支，或异常高涨的单项目开销。
• 多工具团队对比：同时使用多个编码 Agent，需要横向比较各自的成本与行为。
• 供应商归属分析：弄清每笔开销实际流向了哪家模型厂商。
• 本地隐私要求：不愿把用量数据上传第三方分析服务的个人与团队。

适用人群

日常使用两个以上 AI 编程工具、关心 Token 与订阅成本的开发者；需要向团队或上级汇报 AI 编程投入产出的负责人；希望在完全本地环境完成用量分析的隐私敏感用户。

工作原理

codex-stats 不做网络代理，只读本机文件：解析 Codex 的 sqlite 与 rollout JSONL、OpenCode 与 Hermes 的数据库、Claude Code 的会话转录，把它们归一化成统一的会话模型——统一模型名（剥掉 vendor/ 前缀以便归并厂商）、统一分支归属（按会话多数事件落地的分支）、统一成本口径（记录值优先，缺省用模型名估算）。无法归属厂商的花费单独列为「未识别」而不是丢弃，截断历史时也会在指标上方声明。最后把结果渲染成单文件 HTML 仪表盘写入缓存目录并交给浏览器打开。

官方链接

• PyPI 主页：https://pypi.org/project/codex-stats/
• GitHub 仓库：https://github.com/vivek378521/codex-stats
• 排行榜：https://codex-stats-leaderboard.vercel.app