OpenClaw · Skill

model-usage

Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns.

Skills

vOfficial

Install

Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.

Primary command

openclaw install openclaw/model-usage

ClawHub installer

npx clawhub@latest install openclaw/model-usage

OpenClaw CLI

openclaw skills install openclaw/model-usage

View source

What this skill does

Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns.

Typical use cases

Install this skill when you want a reusable OpenClaw workflow with clearer instructions than a one-off prompt.

Source instructions

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

Fetch cost JSON via CodexBar CLI or pass a JSON file.
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>.
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.

Related OpenClaw skills

Browse all →

OpenClaw Skill