BeClaude

ccusage

New
15.9kGitHubGeneralby ryoppippi

Analyze coding (agent) CLI token usage and costs from local data.

First seen 5/24/2026

Summary

This skill analyzes local CLI token usage data from coding agents, helping developers track and estimate costs.

  • It parses usage logs to provide insights into token consumption patterns and associated expenses.

Install & Usage

1
Create the agents directory
mkdir -p .claude/agents
2
Save the agent file

Add the configuration to .claude/agents/ccusage.md

3
Invoke with @agent-name
@ccusage

Use Cases

Check total token usage and cost for the current session or project.
Compare token consumption across different coding agents or models.
Identify which commands or tasks consumed the most tokens.
Generate a cost report for a specific time period or agent session.
Monitor token usage trends to optimize agent efficiency and reduce costs.
Export token usage data for billing or budgeting purposes.

Usage Examples

1

/ccusage show total tokens and cost for this session

2

/ccusage analyze token usage by agent type over the last week

3

/ccusage export cost report in CSV format

View source on GitHub
agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is ccusage?

This skill analyzes local CLI token usage data from coding agents, helping developers track and estimate costs. It parses usage logs to provide insights into token consumption patterns and associated expenses.

How to install ccusage?

To install ccusage: create the agents directory (mkdir -p .claude/agents), then add the config to .claude/agents/ccusage.md. Finally, @ccusage in Claude Code.

What is ccusage best for?

ccusage is a agent categorized under General. It is designed for: agent. Created by ryoppippi.

What can I use ccusage for?

ccusage is useful for: Check total token usage and cost for the current session or project.; Compare token consumption across different coding agents or models.; Identify which commands or tasks consumed the most tokens.; Generate a cost report for a specific time period or agent session.; Monitor token usage trends to optimize agent efficiency and reduce costs.; Export token usage data for billing or budgeting purposes..