← Back to Skills Marketplace
Model Usage
by
JustAskNudge
· GitHub ↗
· v0.1.0
572
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install model-usage-skill
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. Trig...
Usage Guidance
This skill appears to do what it says: run the CodexBar CLI or parse a CodexBar JSON export and summarize per-model costs. Before installing, confirm you trust the Homebrew tap (steipete/tap) used to install codexbar, since third-party taps have higher supply-chain risk than official packages. Also note that CodexBar itself will read local cost logs under your home directory (as documented) when you run it — if you don't want that, run the bundled Python script on an exported JSON file instead. If you'd like greater assurance, review the upstream codexbar source or the installed cask before installing.
Capability Analysis
Type: OpenClaw Skill
Name: model-usage-skill
Version: 0.1.0
The skill is designed to summarize AI model usage costs from the local CodexBar CLI. The `SKILL.md` provides clear instructions for the agent to run the bundled Python script or `codexbar` itself, without any prompt injection attempts. The `scripts/model_usage.py` script executes the `codexbar` binary using `subprocess.check_output` with a list of arguments, which is a safe method that prevents shell injection. Input parameters are validated via `argparse` choices. The script processes JSON output from `codexbar` or a specified file/stdin, extracting data without executing arbitrary code. There is no evidence of data exfiltration, persistence, unauthorized network activity, or obfuscation. All observed behavior aligns with the stated purpose.
Capability Assessment
Purpose & Capability
Name/description ask for per-model cost summaries from CodexBar; the skill only requires the codexbar CLI and a Python script that calls 'codexbar cost' or reads a provided JSON file. Required binaries and OS restriction (darwin) match the stated purpose.
Instruction Scope
SKILL.md and the script stay on-topic: they run 'codexbar cost --format json --provider', accept file/stdin input, parse local cost JSON, and render summaries. The instructions do not direct the agent to read unrelated system files or network endpoints.
Install Mechanism
Install uses a Homebrew cask from the steipete/tap (third-party) tap. This is expected to install the codexbar binary but carries the usual trust considerations for third-party brew taps (moderate supply-chain risk compared to official packages).
Credentials
The skill declares no environment variables, no credentials, and the code does not attempt to read undisclosed env vars. Access to local cost logs is performed indirectly via the codexbar CLI or user-supplied JSON, which is appropriate for the task.
Persistence & Privilege
Skill is not always-enabled and does not request persistent system-wide privileges. It does not modify other skills or global agent config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install model-usage-skill - After installation, invoke the skill by name or use
/model-usage-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- First release of the model-usage skill.
- Summarizes per-model usage and cost from CodexBar CLI logs for Codex or Claude.
- Supports both “current model” (latest daily entry) and full model breakdowns.
- Accepts input from CodexBar CLI output, file, or stdin.
- Provides flexible output formats: text or JSON.
- macOS support with homebrew install instructions; Linux guidance coming soon.
Metadata
Frequently Asked Questions
What is Model Usage?
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. Trig... It is an AI Agent Skill for Claude Code / OpenClaw, with 572 downloads so far.
How do I install Model Usage?
Run "/install model-usage-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Model Usage free?
Yes, Model Usage is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Model Usage support?
Model Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created Model Usage?
It is built and maintained by JustAskNudge (@justasknudge); the current version is v0.1.0.
More Skills