Metadata-Version: 2.4
Name: codex-stat
Version: 0.1.1
Summary: Query Codex CLI token usage from local session JSONL logs.
Keywords: codex,openai,token,usage,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: rich>=14.3.3

# 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 单价估算成本

## 本地开发

```bash
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
```

## 成本估算

```bash
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`
