mcpField
M
model-usage

model-usage

github.com/openclawAgent workflows393.3k5.5k installsUpdated today
Repository

About model-usage

Model usage is a skill that summarizes per-model costs from CodexBar logs for Codex or Claude. It supports current-model and all-model views, with text or JSON output.

Key features

  1. 01Summarize current or all models
  2. 02Read local CodexBar cost data
  3. 03Accept exported JSON or stdin
  4. 04Output text or formatted JSON

Use cases

  1. 01Check the latest model's cost
  2. 02Compare costs across models
  3. 03Summarize exported CodexBar data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaw/openclaw --skill model-usage

After installing, type/model-usagein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
codexbar-cli.md
scripts/
test_model_usage.py
model_usage.py

Details

From the project README

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.

CodexBar ships CLI builds for macOS and Linux. When codexbar is on PATH, the skill reads local usage directly; the bundled Python summarizer also accepts exported CodexBar JSON through --input anywhere Python is available.

Quick start

  1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
  2. Use the bundled script to summarize by model.
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>.
  • macOS and Linux: use the bundled Homebrew formula installer above for live local usage reads. Linux users can also use CodexBar's AUR package or official release tarballs.
  • Other platforms: use --input with exported CodexBar JSON.
  • File or stdin:
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.

Comments

Markdown supported