ccusage 10.0.0 → 11.0.1

package/README.md

@@ -41,6 +41,7 @@ This tool helps you understand the value you're getting from your subscription b
 - 📊 **Daily Report**: View token usage and costs aggregated by date
 - 📅 **Monthly Report**: View token usage and costs aggregated by month
 - 💬 **Session Report**: View usage grouped by conversation sessions
+- ⏰ **5-Hour Blocks Report**: Track usage within Claude's billing windows with active block monitoring
 - 🤖 **Model Tracking**: See which Claude models you're using (Opus, Sonnet, etc.)
 - 📊 **Model Breakdown**: View per-model cost breakdown with `--breakdown` flag
 - 📅 **Date Filtering**: Filter reports by date range using `--since` and `--until`
@@ -51,6 +52,7 @@ This tool helps you understand the value you're getting from your subscription b
 - 🔄 **Cache Token Support**: Tracks and displays cache creation and cache read tokens separately
 - 🌐 **Offline Mode**: Use pre-cached pricing data without network connectivity with `--offline` (Claude models only)
 - 📏 **Responsive Tables**: Automatic table width adjustment for narrow terminals with intelligent word wrapping
+- 🔌 **MCP Integration**: Built-in Model Context Protocol server for integration with other tools
 
 ## Important Disclaimer
 
@@ -112,7 +114,7 @@ cd ccusage
 bun install
 
 # Run the tool
-bun run report [subcommand] [options]
+bun run start [subcommand] [options]
 ```
 
 ## Usage
@@ -340,6 +342,8 @@ Available MCP tools:
 
 - `daily`: Returns daily usage reports (accepts `since`, `until`, `mode` parameters)
 - `session`: Returns session usage reports (accepts `since`, `until`, `mode` parameters)
+- `monthly`: Returns monthly usage reports (accepts `since`, `until`, `mode` parameters)
+- `blocks`: Returns 5-hour billing blocks usage reports (accepts `since`, `until`, `mode` parameters)
 
 #### Claude Desktop Configuration Example
 
@@ -462,6 +466,28 @@ This tool was inspired by [this excellent article](https://note.com/milliondev/n
 
 While the original approach uses DuckDB for analysis, this tool provides a more accessible CLI interface with the same core functionality - analyzing the same JSONL files that Claude Code stores locally to give you insights into your usage patterns and costs.
 
+## Related Projects
+
+some projects use `ccusage` internally and provide additional features:
+
 ## Acknowledgments
 
 Thanks to [@milliondev](https://note.com/milliondev) for the original concept and approach to Claude Code usage analysis.
+
+## Sponsors
+
+<p align="center">
+	<a href="https://github.com/sponsors/ryoppippi">
+		<img src="https://cdn.jsdelivr.net/gh/ryoppippi/sponsors/sponsors.svg">
+	</a>
+</p>
+
+## Star History
+
+<a href="https://www.star-history.com/#ryoppippi/ccusage&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ryoppippi/ccusage&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ryoppippi/ccusage&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ryoppippi/ccusage&type=Date" />
+ </picture>
+</a>

package/dist/{calculate-cost-2IwHSzmi.js → calculate-cost-D3IraeGW.js}

@@ -1,4 +1,9 @@
 //#region src/calculate-cost.ts
+/**
+* Calculates total token usage and cost across multiple usage data entries
+* @param data - Array of daily, monthly, or session usage data
+* @returns Aggregated token totals and cost
+*/
 function calculateTotals(data) {
 	return data.reduce((acc, item) => ({
 		inputTokens: acc.inputTokens + item.inputTokens,
@@ -14,9 +19,19 @@ function calculateTotals(data) {
 		totalCost: 0
 	});
 }
+/**
+* Calculates the sum of all token types (input, output, cache creation, cache read)
+* @param tokens - Token data containing different token counts
+* @returns Total number of tokens across all types
+*/
 function getTotalTokens(tokens) {
 	return tokens.inputTokens + tokens.outputTokens + tokens.cacheCreationTokens + tokens.cacheReadTokens;
 }
+/**
+* Creates a complete totals object by adding total token count to existing totals
+* @param totals - Token totals with cost information
+* @returns Complete totals object including total token sum
+*/
 function createTotalsObject(totals) {
 	return {
 		inputTokens: totals.inputTokens,

package/dist/calculate-cost.d.ts

@@ -1,21 +1,45 @@
-import "./pricing-fetcher-BkSZh4lR.js";
-import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-DPQaq8_n.js";
+import "./pricing-fetcher-DHaTs-k2.js";
+import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-dbZm5kOW.js";
 
 //#region src/calculate-cost.d.ts
+/**
+ * Token usage data structure containing input, output, and cache token counts
+ */
 type TokenData = {
   inputTokens: number;
   outputTokens: number;
   cacheCreationTokens: number;
   cacheReadTokens: number;
 };
+/**
+ * Token totals including cost information
+ */
 type TokenTotals = TokenData & {
   totalCost: number;
 };
+/**
+ * Complete totals object with token counts, cost, and total token sum
+ */
 type TotalsObject = TokenTotals & {
   totalTokens: number;
 };
+/**
+ * Calculates total token usage and cost across multiple usage data entries
+ * @param data - Array of daily, monthly, or session usage data
+ * @returns Aggregated token totals and cost
+ */
 declare function calculateTotals(data: Array<DailyUsage | MonthlyUsage | SessionUsage>): TokenTotals;
+/**
+ * Calculates the sum of all token types (input, output, cache creation, cache read)
+ * @param tokens - Token data containing different token counts
+ * @returns Total number of tokens across all types
+ */
 declare function getTotalTokens(tokens: TokenData): number;
+/**
+ * Creates a complete totals object by adding total token count to existing totals
+ * @param totals - Token totals with cost information
+ * @returns Complete totals object including total token sum
+ */
 declare function createTotalsObject(totals: TokenTotals): TotalsObject;
 //#endregion
 export { calculateTotals, createTotalsObject, getTotalTokens };

package/dist/calculate-cost.js

@@ -1,3 +1,3 @@
-import { calculateTotals, createTotalsObject, getTotalTokens } from "./calculate-cost-2IwHSzmi.js";
+import { calculateTotals, createTotalsObject, getTotalTokens } from "./calculate-cost-D3IraeGW.js";
 
 export { calculateTotals, createTotalsObject, getTotalTokens };