Skip to content
Get packs

Model Usage Summary

Summarize per-model Codex or Claude cost usage from local CodexBar logs on macOS

Source Download skill
Repository
spinabot/brigade
Stars
11,367
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent to read cost records produced by the CodexBar command-line tool, which tracks local usage logs for Codex and Claude. Once installed, the agent can report which model you used most recently or break down cost across all models, either as readable text or as JSON for further processing. It runs a bundled Python script to do the summarising.

Great for

  • Developers who want to see how much each Codex or Claude model costs them
  • People building scripts that need a per-model usage summary in JSON
  • Macs users already running CodexBar

Skip it if

  • Linux or Windows users, since the metadata limits it to macOS (darwin) and the docs say Linux install is not yet documented
  • Anyone without CodexBar installed, because the skill only reads data that CodexBar produces and the logs need that tool
  • Exact token accounting per model, since CodexBar does not split tokens by model, so only cost is available

Try asking

  • “Show me which model I used most recently in Codex and what it cost”
  • “Give me a full cost breakdown by model for Claude this month as JSON”
  • “Summarise my Codex usage across all models from this cost file”
Step-by-step guide: how to use Model Usage SummaryInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    model-usage.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip model-usage.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip model-usage.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Save codexbar output to a file first and pass it with --input so you can inspect the data before summarising
  • Use --format json --pretty when you plan to feed results into another tool
  • Use --model to override the automatic 'current model' choice when you need a specific model

What's inside

  • SKILL.md

Redistributed unmodified from spinabot/brigade under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.