Model usage

SkillAI & models

Find out what your AI usage is costing, model by model. Once added, your agent can read your local CodexBar cost logs and summarize usage for Codex or Claude, either for the most recent model or as a full breakdown across all models.

Available today. Use it from your connected AI after setup.

Add the skill, then ask your agent for a model usage or cost summary, such as a per-model breakdown of your recent usage.

Then ask your AI: use the Model usage skill

What your AI can do with it

  • Summarize AI usage costs from your local CodexBar logs
  • Break down costs per model for Codex or Claude
  • Report usage for the most recent model
  • Give a full cost breakdown across all models
  • Answer questions about model-level usage and cost data

What this skill tells your AI

The instructions your AI receives, as published by bitterbot-ai/bitterbot-desktop in skills/model-usage/SKILL.md and read by ahel’s review.

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.

TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.

Quick start

  1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
  2. 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>.
  • 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.

Signals

GitHub stars
2k
Forks
417
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
model-usage-bitterbot-ai
Source
github.com/bitterbot-ai/bitterbot-desktop