AgentSkillsCN

model-usage

使用CodexBar CLI本地成本统计功能，为Codex或Claude的各模型用量进行汇总，包括当前（最新）模型，或对全模型进行细分统计。当用户请求从CodexBar获取模型级别的用量/成本数据，或需要从CodexBar的成本JSON中生成可编程的模型级汇总时，可触发此功能。

SKILL.md
--- frontmatter
name: model-usage
description: Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
metadata:
    {
        'i-clavdivs':
            {
                'emoji': '📊',
                'os': ['darwin'],
                'requires': { 'bins': ['codexbar'] },
                'install':
                    [
                        {
                            'id': 'brew-cask',
                            'kind': 'brew',
                            'cask': 'steipete/tap/codexbar',
                            'bins': ['codexbar'],
                            'label': 'Install CodexBar (brew cask)',
                        },
                    ],
            },
    }

Model usage

Overview

Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.

TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.

Quick start

  1. •Fetch cost JSON via CodexBar CLI or pass a JSON file.
  2. •Use the bundled script to summarize by model.
bash
python {baseDir}/scripts/model_usage.py --provider codex --mode current
python {baseDir}/scripts/model_usage.py --provider codex --mode all
python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty

Current model logic

  • •Uses the most recent daily row with modelBreakdowns.
  • •Picks the model with the highest cost in that row.
  • •Falls back to the last entry in modelsUsed when breakdowns are missing.
  • •Override with --model <name> when you need a specific model.

Inputs

  • •Default: runs codexbar cost --format json --provider <codex|claude>.
  • •File or stdin:
bash
codexbar cost --provider codex --format json > /tmp/cost.json
python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current

Output

  • •Text (default) or JSON (--format json --pretty).
  • •Values are cost-only per model; tokens are not split by model in CodexBar output.

References

  • •Read references/codexbar-cli.md for CLI flags and cost JSON fields.