codex-stat 0.1.1

Query Codex CLI token usage from local session JSONL logs.

codex-stat

一个可以读取本地 ~/.codex/sessions 日志、统计 Codex token 用量并估算价格的命令行工具。

发布到 PyPI 后，可以通过 uvx codex-stat 直接调用。

功能

• 默认使用 Asia/Shanghai 时区展示和计算时间范围
• 可以通过 --timezone 手动指定其他时区，如 UTC、America/Los_Angeles
• 展示口径为 Input、Output、Cache、Total
• 其中 Input 代表非缓存输入，即 input_tokens - cached_input_tokens
• 输出人类可读报表或 JSON
• 按每 1M token 单价估算成本

本地开发

uv run codex-stat --range today
uv run codex-stat --range 7d --limit 5
uv run codex-stat --range today --timezone UTC
uv run codex-stat --from-date 2026-03-01 --to-date 2026-03-06
uv run codex-stat --range today --json

成本估算

uv run codex-stat \
  --range today \
  --input-price-per-m 0.625 \
  --cached-input-price-per-m 0.0625 \
  --output-price-per-m 5

估价公式：

• Input = input_tokens - cached_input_tokens
• 总费用 = 非缓存输入费用 + 缓存输入费用 + 输出费用
• Cache = cached_input_tokens
• Total 使用日志里的 total_tokens