my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

my-project-public — gitlawb

#1	---
#2	name: model-usage
#3	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.
#4	metadata: {"clawdbot":{"emoji":"📊","os":["darwin"],"requires":{"bins":["codexbar"]},"install":[{"id":"brew-cask","kind":"brew","cask":"steipete/tap/codexbar","bins":["codexbar"],"label":"Install CodexBar (brew cask)"}]}}
#5	---
#6
#7	# Model usage
#8
#9	## Overview
#10	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.
#11
#12	TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.
#13
#14	## Quick start
#15	1) Fetch cost JSON via CodexBar CLI or pass a JSON file.
#16	2) Use the bundled script to summarize by model.
#17
#18	```bash
#19	python {baseDir}/scripts/model_usage.py --provider codex --mode current
#20	python {baseDir}/scripts/model_usage.py --provider codex --mode all
#21	python {baseDir}/scripts/model_usage.py --provider claude --mode all --format json --pretty
#22	```
#23
#24	## Current model logic
#25	- Uses the most recent daily row with `modelBreakdowns`.
#26	- Picks the model with the highest cost in that row.
#27	- Falls back to the last entry in `modelsUsed` when breakdowns are missing.
#28	- Override with `--model <name>` when you need a specific model.
#29
#30	## Inputs
#31	- Default: runs `codexbar cost --format json --provider <codex\|claude>`.
#32	- File or stdin:
#33
#34	```bash
#35	codexbar cost --provider codex --format json > /tmp/cost.json
#36	python {baseDir}/scripts/model_usage.py --input /tmp/cost.json --mode all
#37	cat /tmp/cost.json \| python {baseDir}/scripts/model_usage.py --input - --mode current
#38	```
#39
#40	## Output
#41	- Text (default) or JSON (`--format json --pretty`).
#42	- Values are cost-only per model; tokens are not split by model in CodexBar output.
#43
#44	## References
#45	- Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.
#46

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public