← Back to Skills Marketplace
Model Usage Linux
by
HablaBechir
· GitHub ↗
· v1.0.0
1070
Downloads
0
Stars
15
Active Installs
1
Versions
Install in OpenClaw
/install model-usage-linux
Description
Track OpenClaw AI token usage and cost per model on Linux by parsing session JSONL files. Use when asked about: token usage, API cost, how much has been spen...
Usage Guidance
This skill appears to be a local analyzer that reads your OpenClaw session JSONL files and prints usage/cost summaries. Before running: (1) confirm the sessions directory path is correct and contains only data you want analyzed, (2) review the included scripts/usage.py (it is short and clearly local-only), and (3) run it locally (or point it at a copy of the sessions) if you want to avoid analyzing live files. There is no network or credential access in the code, so risk is low, but avoid running arbitrary code you haven't inspected on sensitive systems.
Capability Analysis
Type: OpenClaw Skill
Name: model-usage-linux
Version: 1.0.0
The skill 'model-usage-linux' is designed to analyze OpenClaw AI token usage and cost from local session JSONL files. The `SKILL.md` provides clear, benign instructions for running the `scripts/usage.py` script. The Python script itself only reads and parses JSONL files from a specified directory (defaulting to `~/.openclaw/agents/main/sessions`), performs calculations, and prints a summary to standard output. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent. The code is straightforward, uses standard libraries, and strictly adheres to its stated purpose without engaging in any high-risk behaviors.
Capability Assessment
Purpose & Capability
The skill name/description say it parses OpenClaw session JSONL files to report token/cost per model. The included script reads ~/.openclaw/agents/main/sessions/*.jsonl by default and computes per-model usage and cost. No unrelated dependencies, env vars, or binaries are requested — this is proportionate to the stated purpose.
Instruction Scope
SKILL.md instructs running the bundled Python script and optionally specifying a sessions directory or JSON output. The script only reads session JSONL files, does not access other system config, environment variables, or network endpoints, and prints a local summary. It silently skips malformed JSON lines and uses a default sessions path; this is within expected scope.
Install Mechanism
There is no install spec (instruction-only + included script). Nothing is downloaded or written to system locations by an installer. Running the script requires a local Python interpreter but no install-time network activity or package fetches are specified.
Credentials
The skill requests no environment variables, no credentials, and no special config paths beyond reading the user's OpenClaw sessions directory (~/.openclaw/agents/main/sessions). This is appropriate for a local usage-reporting tool.
Persistence & Privilege
The skill is not marked always: true and does not attempt to persist configuration or modify other skills. It runs as a normal user script and does not request elevated privileges or system-wide changes.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install model-usage-linux - After installation, invoke the skill by name or use
/model-usage-linux - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of model-usage-linux.
- Track OpenClaw AI token usage and cost per model by parsing Linux session JSONL files.
- Provides per-model breakdown: turns, input/output tokens, cache usage, and cost in USD.
- Includes CLI options for output format and custom session directory.
- Designed as a Linux replacement for the macOS-only model-usage/CodexBar skill.
Metadata
Frequently Asked Questions
What is Model Usage Linux?
Track OpenClaw AI token usage and cost per model on Linux by parsing session JSONL files. Use when asked about: token usage, API cost, how much has been spen... It is an AI Agent Skill for Claude Code / OpenClaw, with 1070 downloads so far.
How do I install Model Usage Linux?
Run "/install model-usage-linux" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Model Usage Linux free?
Yes, Model Usage Linux is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Model Usage Linux support?
Model Usage Linux is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Model Usage Linux?
It is built and maintained by HablaBechir (@hablabechir); the current version is v1.0.0.
More Skills