A professional reporting tool that tracks Claude Code token consumption, cache hits, and real-time API expenditure.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ccusage-report
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ccusage-report using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Claude Code Usage Reporter?
The Claude Code Usage Reporter is a specialized utility designed to give developers full transparency over their AI development costs. By utilizing the ccusage tool via bunx, this skill extracts detailed metrics from your Claude Code sessions, including input and output tokens, context caching efficiency, and total financial impact in USD. It is an essential component of the Openclaw Skills ecosystem for anyone looking to manage their AI budget effectively.
This skill automates the process of querying session logs, allowing users to request summaries for specific timeframes through simple natural language. Whether you need a quick check on today's spend or a detailed monthly breakdown, this skill processes the raw data and presents it in a clean, actionable format.
Claude Code Usage Reporter Use Cases
- Monitoring daily API spend during intensive coding sessions.
- Generating weekly or monthly cost reports for project management and accounting.
- Analyzing token usage patterns to optimize context caching and reduce expenses.
- Auditing model-specific consumption to understand which AI models are driving costs.
How Claude Code Usage Reporter Works
- The agent parses the user's request to determine the required timeframe (daily, weekly, or monthly).
- It maps the request to the appropriate ccusage subcommand and calculates date flags if specific ranges are mentioned.
- The skill executes the bunx ccusage command with parameters like --no-color and --breakdown to retrieve raw usage data.
- It sanitizes and formats the command output into a structured report covering models used, tokens consumed, and total cost.
- The final summary is delivered to the user through their preferred interface, such as a terminal chat or an automated notification system.
Claude Code Usage Reporter Setup
To use this skill within your Openclaw Skills environment, ensure that Bun is installed on your system as it relies on bunx to execute the usage reporter without manual installation.
# Verify Bun installation
bun --version
# The skill invokes ccusage automatically, but you can test it manually:
bunx ccusage daily
Claude Code Usage Reporter Data Schema & Taxonomy
The skill organizes usage data into a concise schema that highlights financial and technical metrics. The output typically follows this structure:
| Data Point | Description |
|---|---|
| Period | The specific date or range being reported |
| Models | A list of Anthropic models utilized in the sessions |
| Input/Output | The count of tokens sent to and received from the API |
| Cache Read | Tokens served from the cache, reducing overall costs |
| Total Cost | The calculated expenditure in USD based on current pricing |
Claude Code Usage Reporter Advanced Features
- Support for granular model breakdowns to see costs per specific AI model version.
- Custom date range filtering using --since and --until flags for historical auditing.
- Timezone-aware reporting to ensure usage data aligns with the developer's local day.
- Automated integration for Telegram or Slack bots to receive scheduled usage summaries.
SKILL.md
Loading
Related Openclaw Skills
Superpowers Mode
A high-discipline engineering workflow skill that enforces structured planning, TDD, and risk assessment for complex coding tasks.
Playwright MCP Browser Automation
A high-performance browser automation skill that enables AI agents to control web browsers via the Model Context Protocol.
Playwright Browser Automation
A high-performance browser automation skill for Openclaw Skills that leverages the direct Playwright API for reliable web interaction and data extraction.
NotebookLM Ops
A specialized automation suite for managing the Google NotebookLM MCP authentication lifecycle and virtual browser stack on Linux.
Idea Spark
Idea Spark is an automated research agent that scans developer communities for real-world pain points to generate and validate actionable project ideas.
OpenClaw Self-Update
An automated maintenance skill that checks for version updates and upgrades the OpenClaw installation via npm.
METADATA
Featured*
