model-usage

Original：🇺🇸 English
Not Translated
1 scriptsChecked / no sensitive code detected

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.

1installs
Sourcemmcmedia/openclaw-agents
Added on

NPX Install

npx skill4agent add mmcmedia/openclaw-agents model-usage

SKILL.md Content

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.