mirror of https://github.com/openclaw/openclaw.git synced 2026-08-23 02:45:38 -06:00

Files

T

Santiago c4f1661f70 docs(skills): allow model-usage with Linux codexbar (#87986 )

* docs(skills): support CodexBar CLI on Linux

Enable the existing model-usage skill on Linux when the supported CodexBar CLI is present, and document the official Homebrew, AUR, and release-tarball install paths.

Co-authored-by: Santiago <shbernal.01@gmail.com>

* docs(skills): link CodexBar Linux packages

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>

2026-07-21 11:04:46 -07:00

2.5 KiB

Raw Permalink Blame History

name, description, metadata

name

description

metadata

model-usage

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

openclaw

emoji

requires

install

📊

darwin

linux

bins

codexbar

kind

formula

bins

label

brew-cask

brew

steipete/tap/codexbar

codexbar

Install CodexBar CLI (Homebrew)

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

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>.
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.

2.5 KiB Raw Permalink Blame History