命令行
ccgauge report
格式化的、无 server 的终端用量报告。读的就是仪表盘读的那份 JSONL，0.2 秒内打出彩色对齐的总结。 本地随手查昨天花了多少，或者 --json 走管道接你的脚本。
常用示例
默认：近 7 天，全部数据源，前 10 个模型
bash
ccgauge report30 天 + 按项目分组
bash
ccgauge report -r 30d -b project只看 Codex 的 gpt-5.5 系列
bash
ccgauge report -s codex -m gpt-5.5JSON 输出给脚本用
bash
ccgauge report --json | jq .totals任意日期区间
bash
ccgauge report --since 2026-05-01 --until 2026-05-08极简：只看总数
bash
ccgauge report --no-trend --no-breakdown参数清单
| 参数 | 默认 | 作用 |
|---|---|---|
-r, --range <range> | 7d | today / 1d / 7d / 30d / 90d / all |
-s, --source <provider> | all | claude / codex / all |
-b, --by <dim> | model | 分组维度：model / project / session |
-g, --gran <granularity> | day | 趋势粒度：hour / day / week / month |
-n, --limit <n> | 10 | 分组表行数 |
--since <date> | — | 自定义起始日期（ISO 或 YYYY-MM-DD） |
--until <date> | — | 自定义截止日期 |
-m, --model <pat> | — | 按模型名子串过滤 |
--project <pat> | — | 按项目名 / cwd 子串过滤 |
-j, --json | off | 输出 JSON 而不是格式化文本 |
--no-color | — | 关闭 ANSI 颜色（管道里自动关） |
--no-trend | — | 不打趋势图 |
--no-breakdown | — | 不打分组表 |
小贴士
- 仅日期形式的
--since/--until走本地日历日边界。--until 2026-05-08包含整个 5 月 8 号。 - 不会启动 server。 直接读磁盘 JSONL，stdout 一冲完进程就退出。CI 里调用也安全。
- 颜色自动关 —— stdout 不是 TTY 时无需手动
--no-color。 - JSON 输出 含
totals、trend、breakdown三个数组。结构稳定，脚本放心消费。