ccusage 10.0.0 → 11.0.0

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
 
@@ -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
 

package/dist/{data-loader-Bp9KV0_a.js → data-loader-BAoqS297.js}

@@ -1,7 +1,7 @@
 import { __commonJS, __require, __toESM } from "./chunk-BLXvPPr8.js";
 import { array, number, object, optional, pipe, regex, safeParse, string } from "./dist-DCvt9hEv.js";
-import { logger } from "./logger-C2GZVy1v.js";
-import { PricingFetcher } from "./pricing-fetcher-BxlbW4km.js";
+import { logger } from "./logger-D3WD64Tx.js";
+import { PricingFetcher } from "./pricing-fetcher-D-eJQBEJ.js";
 import fsPromises, { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";

package/dist/data-loader.js

@@ -1,6 +1,6 @@
-import { DailyUsageSchema, ModelBreakdownSchema, MonthlyUsageSchema, SessionUsageSchema, UsageDataSchema, calculateCostForEntry, createUniqueHash, formatDate, formatDateCompact, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData, sortFilesByTimestamp } from "./data-loader-Bp9KV0_a.js";
+import { DailyUsageSchema, ModelBreakdownSchema, MonthlyUsageSchema, SessionUsageSchema, UsageDataSchema, calculateCostForEntry, createUniqueHash, formatDate, formatDateCompact, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData, sortFilesByTimestamp } from "./data-loader-BAoqS297.js";
 import "./dist-DCvt9hEv.js";
-import "./logger-C2GZVy1v.js";
-import "./pricing-fetcher-BxlbW4km.js";
+import "./logger-D3WD64Tx.js";
+import "./pricing-fetcher-D-eJQBEJ.js";
 
 export { DailyUsageSchema, ModelBreakdownSchema, MonthlyUsageSchema, SessionUsageSchema, UsageDataSchema, calculateCostForEntry, createUniqueHash, formatDate, formatDateCompact, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData, sortFilesByTimestamp };

package/dist/{debug-bjc38_Gx.js → debug-DzFJHzM5.js}

@@ -1,8 +1,8 @@
 import { __toESM } from "./chunk-BLXvPPr8.js";
-import { UsageDataSchema, glob, require_usingCtx } from "./data-loader-Bp9KV0_a.js";
+import { UsageDataSchema, glob, require_usingCtx } from "./data-loader-BAoqS297.js";
 import { safeParse } from "./dist-DCvt9hEv.js";
-import { logger } from "./logger-C2GZVy1v.js";
-import { PricingFetcher } from "./pricing-fetcher-BxlbW4km.js";
+import { logger } from "./logger-D3WD64Tx.js";
+import { PricingFetcher } from "./pricing-fetcher-D-eJQBEJ.js";
 import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";

package/dist/debug.js

@@ -1,7 +1,7 @@
-import "./data-loader-Bp9KV0_a.js";
+import "./data-loader-BAoqS297.js";
 import "./dist-DCvt9hEv.js";
-import "./logger-C2GZVy1v.js";
-import "./pricing-fetcher-BxlbW4km.js";
-import { detectMismatches, printMismatchReport } from "./debug-bjc38_Gx.js";
+import "./logger-D3WD64Tx.js";
+import "./pricing-fetcher-D-eJQBEJ.js";
+import { detectMismatches, printMismatchReport } from "./debug-DzFJHzM5.js";
 
 export { detectMismatches, printMismatchReport };

package/dist/index.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import { __commonJS, __toESM } from "./chunk-BLXvPPr8.js";
 import { calculateTotals, createTotalsObject, getTotalTokens } from "./calculate-cost-2IwHSzmi.js";
-import { calculateBurnRate, filterRecentBlocks, formatDateCompact, getDefaultClaudePath, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData, projectBlockUsage } from "./data-loader-Bp9KV0_a.js";
+import { calculateBurnRate, filterRecentBlocks, formatDateCompact, getDefaultClaudePath, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData, projectBlockUsage } from "./data-loader-BAoqS297.js";
 import { safeParse } from "./dist-DCvt9hEv.js";
-import { description, log, logger, name, version } from "./logger-C2GZVy1v.js";
-import { CostModes, SortOrders, dateSchema } from "./pricing-fetcher-BxlbW4km.js";
-import { detectMismatches, printMismatchReport } from "./debug-bjc38_Gx.js";
+import { description, log, logger, name, version } from "./logger-D3WD64Tx.js";
+import { CostModes, SortOrders, dateSchema } from "./pricing-fetcher-D-eJQBEJ.js";
+import { detectMismatches, printMismatchReport } from "./debug-DzFJHzM5.js";
 import { ResponsiveTable } from "./utils.table-USks3NGv.js";
 import "./types-BlyCnKwN.js";
-import { createMcpServer } from "./mcp-DVjQeqCy.js";
+import { createMcpServer } from "./mcp-1J7r1g6-.js";
 import "./index-CISmcbXk-CW1Gj6Ab.js";
 import process$1 from "node:process";
 

package/dist/{logger-C2GZVy1v.js → logger-D3WD64Tx.js}

@@ -965,7 +965,7 @@ const consola = createConsola$1();
 //#endregion
 //#region package.json
 var name = "ccusage";
-var version = "10.0.0";
+var version = "11.0.0";
 var description = "Usage analysis tool for Claude Code";
 
 //#endregion

package/dist/logger.js

@@ -1,3 +1,3 @@
-import { log, logger } from "./logger-C2GZVy1v.js";
+import { log, logger } from "./logger-D3WD64Tx.js";
 
 export { log, logger };

package/dist/{mcp-DVjQeqCy.js → mcp-1J7r1g6-.js}

@@ -1,8 +1,8 @@
 import { __commonJS, __require, __toESM } from "./chunk-BLXvPPr8.js";
-import { getDefaultClaudePath, loadDailyUsageData, loadSessionData } from "./data-loader-Bp9KV0_a.js";
+import { getDefaultClaudePath, loadDailyUsageData, loadFiveHourBlockData, loadMonthlyUsageData, loadSessionData } from "./data-loader-BAoqS297.js";
 import { description, literal, object, optional, pipe, union } from "./dist-DCvt9hEv.js";
-import { name, version } from "./logger-C2GZVy1v.js";
-import { CostModes, dateSchema } from "./pricing-fetcher-BxlbW4km.js";
+import { name, version } from "./logger-D3WD64Tx.js";
+import { CostModes, dateSchema } from "./pricing-fetcher-D-eJQBEJ.js";
 import { anyType, arrayType, booleanType, discriminatedUnionType, enumType, literalType, numberType, objectType, optionalType, recordType, stringType, unionType, unknownType } from "./types-BlyCnKwN.js";
 import { toJsonSchema } from "./index-CISmcbXk-CW1Gj6Ab.js";
 import process$1 from "node:process";
@@ -37580,6 +37580,30 @@ function createMcpServer({ claudePath } = defaultOptions) {
 			return JSON.stringify(sessionData);
 		}
 	});
+	server.addTool({
+		name: "monthly",
+		description: "Show usage report grouped by month",
+		parameters: parametersSchema,
+		execute: async (args) => {
+			const monthlyData = await loadMonthlyUsageData({
+				...args,
+				claudePath
+			});
+			return JSON.stringify(monthlyData);
+		}
+	});
+	server.addTool({
+		name: "blocks",
+		description: "Show usage report grouped by 5-hour billing blocks",
+		parameters: parametersSchema,
+		execute: async (args) => {
+			const blocksData = await loadFiveHourBlockData({
+				...args,
+				claudePath
+			});
+			return JSON.stringify(blocksData);
+		}
+	});
 	return server;
 }
 

package/dist/mcp.js

@@ -1,9 +1,9 @@
-import "./data-loader-Bp9KV0_a.js";
+import "./data-loader-BAoqS297.js";
 import "./dist-DCvt9hEv.js";
-import "./logger-C2GZVy1v.js";
-import "./pricing-fetcher-BxlbW4km.js";
+import "./logger-D3WD64Tx.js";
+import "./pricing-fetcher-D-eJQBEJ.js";
 import "./types-BlyCnKwN.js";
-import { createMcpServer } from "./mcp-DVjQeqCy.js";
+import { createMcpServer } from "./mcp-1J7r1g6-.js";
 import "./index-CISmcbXk-CW1Gj6Ab.js";
 
 export { createMcpServer };

package/dist/{pricing-fetcher-BxlbW4km.js → pricing-fetcher-D-eJQBEJ.js}

@@ -1,5 +1,5 @@
 import { number, object, optional, pipe, regex, safeParse, string } from "./dist-DCvt9hEv.js";
-import { logger } from "./logger-C2GZVy1v.js";
+import { logger } from "./logger-D3WD64Tx.js";
 
 //#region src/consts.internal.ts
 const LITELLM_PRICING_URL = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";

package/dist/pricing-fetcher.js

@@ -1,5 +1,5 @@
 import "./dist-DCvt9hEv.js";
-import "./logger-C2GZVy1v.js";
-import { PricingFetcher } from "./pricing-fetcher-BxlbW4km.js";
+import "./logger-D3WD64Tx.js";
+import { PricingFetcher } from "./pricing-fetcher-D-eJQBEJ.js";
 
 export { PricingFetcher };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ccusage",
   "type": "module",
-  "version": "10.0.0",
+  "version": "11.0.0",
   "description": "Usage analysis tool for Claude Code",
   "author": "ryoppippi",
   "license": "MIT",