Agent skill · data analytics · steipete
model-usage
Summarize CodexBar local cost logs by model for Codex or Claude, including current or full breakdowns.
Why this skill is useful
Adds a Python script for summarizing model usage costs that is not commonly found in public documentation.
What it needs
Requires codexbar installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
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. 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: 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.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/model-usage