{"skill":{"slug":"model-usage","displayName":"Model Usage","summary":"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.","description":"---\nname: model-usage\ndescription: 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.\nmetadata: {\"clawdbot\":{\"emoji\":\"📊\",\"os\":[\"darwin\"],\"requires\":{\"bins\":[\"codexbar\"]},\"install\":[{\"id\":\"brew-cask\",\"kind\":\"brew\",\"cask\":\"steipete/tap/codexbar\",\"bins\":[\"codexbar\"],\"label\":\"Install CodexBar (brew cask)\"}]}}\n---\n\n# Model usage\n\n## Overview\nGet 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.\n\nTODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.\n\n## Quick start\n1) Fetch cost JSON via CodexBar CLI or pass a JSON file.\n2) Use the bundled script to summarize by model.\n\n```bash\npython {baseDir}/scripts/model_usage.py --provider codex --mode current\npython {baseDir}/scripts/model_usage.py --provider codex --mode all\npython {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty\n```\n\n## Current model logic\n- Uses the most recent daily row with `modelBreakdowns`.\n- Picks the model with the highest cost in that row.\n- Falls back to the last entry in `modelsUsed` when breakdowns are missing.\n- Override with `--model <name>` when you need a specific model.\n\n## Inputs\n- Default: runs `codexbar cost --format json --provider <codex|claude>`.\n- File or stdin:\n\n```bash\ncodexbar cost --provider codex --format json > /tmp/cost.json\npython {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all\ncat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode current\n```\n\n## Output\n- Text (default) or JSON (`--format json --pretty`).\n- Values are cost-only per model; tokens are not split by model in CodexBar output.\n\n## References\n- Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.\n","tags":{"latest":"1.0.0"},"stats":{"comments":1,"downloads":38243,"installsAllTime":1587,"installsCurrent":1582,"stars":114,"versions":1},"createdAt":1767667639455,"updatedAt":1778485729679},"latestVersion":{"version":"1.0.0","createdAt":1767667639455,"changelog":"- Initial release of the model-usage skill for summarizing per-model usage and cost from CodexBar CLI local cost logs.\n- Supports both Codex and Claude providers.\n- Allows fetching summaries for the current (most recent) model or all models.\n- Provides both text and JSON output formats.\n- Can process costs directly from CodexBar CLI output or from a JSON file/stdin.\n- Includes guidance for CLI use and script automation.","license":null},"metadata":{"setup":[],"os":["darwin"],"systems":null},"owner":{"handle":"steipete","userId":"s179zksw999xz8ms4cy7pb2fr183m5jq","displayName":"Peter Steinberger","image":"https://avatars.githubusercontent.com/u/58493?v=4"},"moderation":null}