| 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. |
| version | 2.0.0 |
| kind | pipeline |
| triggers | ["model usage","cost data"] |
| intent | metrics |
| resources | ["<SKILL_PATH>/scripts/model_usage.py"] |
| tools | ["bash","python3"] |
| created_at | 2026-05-30T00:00:00.000Z |
| updated_at | 2026-07-29T00:00:00.000Z |
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.
Note: CodexBar is a macOS menubar app. On Linux/WSL2 there is no native CodexBar CLI — use --input <file> to pass a cost JSON exported from a macOS machine, or pipe JSON directly via stdin.
Quick start
- Fetch cost JSON via CodexBar CLI or pass a JSON file.
- Use the bundled script to summarize by model.
python "<SKILL_PATH>/scripts/model_usage.py" --provider codex --mode current
python "<SKILL_PATH>/scripts/model_usage.py" --provider codex --mode all
python "<SKILL_PATH>/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 "<SKILL_PATH>/scripts/model_usage.py" --input /tmp/cost.json --mode all
cat /tmp/cost.json | python "<SKILL_PATH>/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.
