ccusage 15.9.3 → 15.9.4

package/README.md

@@ -106,11 +106,11 @@ Full documentation is available at **[ccusage.com](https://ccusage.com/)**
 
 ### Featured Sponsor
 
-Check out these [47 Claude Code ProTips from Greg Baugues.](https://www.youtube.com/watch?v=TiNpzxoBPz0&lc=UgyVgQyOhfJJlheVMcB4AaABAg)
+Check out [ccusage: The Claude Code cost scorecard that went viral](https://www.youtube.com/watch?v=Ak6qpQ5qdgk)
 
 <p align="center">
-    <a href="https://www.youtube.com/watch?v=TiNpzxoBPz0&lc=UgyVgQyOhfJJlheVMcB4AaABAg">
-        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/claude_code_protips_thumbnail_v1.png" alt="47 Claude Code ProTips from Greg Baugues" width="600">
+    <a href="https://www.youtube.com/watch?v=Ak6qpQ5qdgk">
+        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/ccusage_thumbnail.png" alt="ccusage: The Claude Code cost scorecard that went viral" width="600">
     </a>
 </p>
 

package/dist/{data-loader-B_nfl1Pr.js → data-loader-CY2f8ZBq.js}

@@ -1,7 +1,7 @@
-import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-DzkXdtDF.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { activityDateSchema, arrayType, booleanType, createBucket, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, createWeeklyDate, dailyDateSchema, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, numberType, objectType, projectPathSchema, requestIdSchema, sessionIdSchema, stringType, unionType, versionSchema, weeklyDateSchema } from "./_types-C0oFKDO-.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { logger } from "./logger-QcakA1fc.js";
 import a, { readFile } from "node:fs/promises";
 import path, { posix } from "node:path";
 import process$1 from "node:process";
@@ -2397,7 +2397,7 @@ function formatDate(dateStr, timezone, locale) {
 	return formatter.format(date);
 }
 function formatDateCompact(dateStr, timezone, locale) {
-	const date = new Date(dateStr), formatter = createDatePartsFormatter(timezone, locale), parts = formatter.formatToParts(date), year = parts.find((p) => p.type === "year")?.value ?? "", month = parts.find((p) => p.type === "month")?.value ?? "", day = parts.find((p) => p.type === "day")?.value ?? "";
+	const parseResult = dailyDateSchema.safeParse(dateStr), date = parseResult.success ? timezone != null ? /* @__PURE__ */ new Date(`${dateStr}T00:00:00Z`) : /* @__PURE__ */ new Date(`${dateStr}T00:00:00`) : new Date(dateStr), formatter = createDatePartsFormatter(timezone, locale), parts = formatter.formatToParts(date), year = parts.find((p) => p.type === "year")?.value ?? "", month = parts.find((p) => p.type === "month")?.value ?? "", day = parts.find((p) => p.type === "day")?.value ?? "";
 	return `${year}\n${month}-${day}`;
 }
 function sortByDate(items, getDate, order = "desc") {

package/dist/data-loader.js

@@ -1,6 +1,6 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-DzkXdtDF.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
-import { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema } from "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
+import { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema } from "./data-loader-CY2f8ZBq.js";
+import "./logger-QcakA1fc.js";
 export { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };

package/dist/{debug-BoSgT8lp.js → debug-mIvd8kZa.js}

@@ -1,6 +1,6 @@
-import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-ZrH9X6Xp.js";
-import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-B_nfl1Pr.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-DzkXdtDF.js";
+import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-CY2f8ZBq.js";
+import { logger } from "./logger-QcakA1fc.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 var import_usingCtx = /* @__PURE__ */ __toESM(require_usingCtx(), 1);

package/dist/debug.js

@@ -1,7 +1,7 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-DzkXdtDF.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
-import "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
-import { detectMismatches, printMismatchReport } from "./debug-BoSgT8lp.js";
+import "./data-loader-CY2f8ZBq.js";
+import "./logger-QcakA1fc.js";
+import { detectMismatches, printMismatchReport } from "./debug-mIvd8kZa.js";
 export { detectMismatches, printMismatchReport };

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, MAX_REFRESH_INTERVAL_SECONDS, MCP_DEFAULT_PORT, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PROJECT_ALIASES_ENV, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-DzkXdtDF.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { CostModes, SortOrders, filterDateSchema, statuslineHookJsonSchema } from "./_types-C0oFKDO-.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
-import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, uniq, usageDataSchema } from "./data-loader-B_nfl1Pr.js";
-import { description, log, logger, name, version } from "./logger-L_zzb0iT.js";
-import { detectMismatches, printMismatchReport } from "./debug-BoSgT8lp.js";
-import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-Bqi6ayed.js";
+import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, uniq, usageDataSchema } from "./data-loader-CY2f8ZBq.js";
+import { description, log, logger, name, version } from "./logger-QcakA1fc.js";
+import { detectMismatches, printMismatchReport } from "./debug-mIvd8kZa.js";
+import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-COJ_l32e.js";
 import a, { readFile } from "node:fs/promises";
 import path from "node:path";
 import process$1 from "node:process";
@@ -3963,14 +3963,105 @@ const monthlyCommand = define({
 		}
 	}
 });
+async function handleSessionIdLookup(ctx, useJson) {
+	const sessionUsage = await loadSessionUsageById(ctx.values.id, {
+		mode: ctx.values.mode,
+		offline: ctx.values.offline
+	});
+	if (sessionUsage == null) {
+		if (useJson) log(JSON.stringify(null));
+		else logger.warn(`No session found with ID: ${ctx.values.id}`);
+		process$1.exit(0);
+	}
+	if (useJson) {
+		const jsonOutput = {
+			sessionId: ctx.values.id,
+			totalCost: sessionUsage.totalCost,
+			totalTokens: calculateSessionTotalTokens(sessionUsage.entries),
+			entries: sessionUsage.entries.map((entry) => ({
+				timestamp: entry.timestamp,
+				inputTokens: entry.message.usage.input_tokens,
+				outputTokens: entry.message.usage.output_tokens,
+				cacheCreationTokens: entry.message.usage.cache_creation_input_tokens ?? 0,
+				cacheReadTokens: entry.message.usage.cache_read_input_tokens ?? 0,
+				model: entry.message.model ?? "unknown",
+				costUSD: entry.costUSD ?? 0
+			}))
+		};
+		if (ctx.values.jq != null) {
+			const jqResult = await processWithJq(jsonOutput, ctx.values.jq);
+			if (isFailure(jqResult)) logger.error(jqResult.error.message), process$1.exit(1);
+			log(jqResult.value);
+		} else log(JSON.stringify(jsonOutput, null, 2));
+	} else {
+		logger.box(`Claude Code Session Usage - ${ctx.values.id}`);
+		const totalTokens = calculateSessionTotalTokens(sessionUsage.entries);
+		if (log(`Total Cost: ${formatCurrency(sessionUsage.totalCost)}`), log(`Total Tokens: ${formatNumber(totalTokens)}`), log(`Total Entries: ${sessionUsage.entries.length}`), log(""), sessionUsage.entries.length > 0) {
+			const table = new ResponsiveTable({
+				head: [
+					"Timestamp",
+					"Model",
+					"Input",
+					"Output",
+					"Cache Create",
+					"Cache Read",
+					"Cost (USD)"
+				],
+				style: { head: ["cyan"] },
+				colAligns: [
+					"left",
+					"left",
+					"right",
+					"right",
+					"right",
+					"right",
+					"right"
+				]
+			});
+			for (const entry of sessionUsage.entries) table.push([
+				formatDateCompact(entry.timestamp, ctx.values.timezone, ctx.values.locale),
+				entry.message.model ?? "unknown",
+				formatNumber(entry.message.usage.input_tokens),
+				formatNumber(entry.message.usage.output_tokens),
+				formatNumber(entry.message.usage.cache_creation_input_tokens ?? 0),
+				formatNumber(entry.message.usage.cache_read_input_tokens ?? 0),
+				formatCurrency(entry.costUSD ?? 0)
+			]);
+			log(table.toString());
+		}
+	}
+}
+function calculateSessionTotalTokens(entries) {
+	return entries.reduce((sum, entry) => {
+		const usage = entry.message.usage;
+		return sum + usage.input_tokens + usage.output_tokens + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0);
+	}, 0);
+}
 var import_picocolors$2 = /* @__PURE__ */ __toESM(require_picocolors(), 1);
 const sessionCommand = define({
 	name: "session",
 	description: "Show usage report grouped by conversation session",
 	...sharedCommandConfig,
+	args: {
+		...sharedCommandConfig.args,
+		id: {
+			type: "string",
+			short: "i",
+			description: "Load usage data for a specific session ID"
+		}
+	},
+	toKebab: true,
 	async run(ctx) {
 		const useJson = ctx.values.json || ctx.values.jq != null;
 		if (useJson) logger.level = 0;
+		if (ctx.values.id != null) return handleSessionIdLookup({ values: {
+			id: ctx.values.id,
+			mode: ctx.values.mode,
+			offline: ctx.values.offline,
+			jq: ctx.values.jq,
+			timezone: ctx.values.timezone,
+			locale: ctx.values.locale ?? "en-CA"
+		} }, useJson);
 		const sessionData = await loadSessionData({
 			since: ctx.values.since,
 			until: ctx.values.until,

package/dist/{logger-L_zzb0iT.js → logger-QcakA1fc.js}

@@ -761,7 +761,7 @@ function _getDefaultLogLevel() {
 	return g ? LogLevels.debug : R ? LogLevels.warn : LogLevels.info;
 }
 const consola = createConsola$1();
-var name = "ccusage", version = "15.9.3", description = "Usage analysis tool for Claude Code";
+var name = "ccusage", version = "15.9.4", description = "Usage analysis tool for Claude Code";
 const logger = consola.withTag(name);
 if (process$1.env.LOG_LEVEL != null) {
 	const level = Number.parseInt(process$1.env.LOG_LEVEL, 10);

package/dist/logger.js

@@ -1,2 +1,2 @@
-import { log, logger } from "./logger-L_zzb0iT.js";
+import { log, logger } from "./logger-QcakA1fc.js";
 export { log, logger };

package/dist/{mcp-Bqi6ayed.js → mcp-COJ_l32e.js}

@@ -1,9 +1,9 @@
-import { __commonJSMin, __toESM, require_usingCtx } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { __commonJSMin, __toESM, require_usingCtx } from "./pricing-fetcher-DzkXdtDF.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { ZodFirstPartyTypeKind, ZodOptional, ZodType, arrayType, booleanType, discriminatedUnionType, enumType, filterDateSchema, literalType, numberType, objectType, optionalType, recordType, stringType, unionType, unknownType } from "./_types-C0oFKDO-.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
-import { getClaudePaths, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData } from "./data-loader-B_nfl1Pr.js";
-import { name, version } from "./logger-L_zzb0iT.js";
+import { getClaudePaths, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData } from "./data-loader-CY2f8ZBq.js";
+import { name, version } from "./logger-QcakA1fc.js";
 import process from "node:process";
 const LATEST_PROTOCOL_VERSION = "2025-06-18", SUPPORTED_PROTOCOL_VERSIONS = [
 	LATEST_PROTOCOL_VERSION,

package/dist/mcp.js

@@ -1,8 +1,8 @@
-import "./pricing-fetcher-ZrH9X6Xp.js";
+import "./pricing-fetcher-DzkXdtDF.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-C0oFKDO-.js";
 import "./calculate-cost-BDqO4yWA.js";
-import "./data-loader-B_nfl1Pr.js";
-import "./logger-L_zzb0iT.js";
-import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-Bqi6ayed.js";
+import "./data-loader-CY2f8ZBq.js";
+import "./logger-QcakA1fc.js";
+import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-COJ_l32e.js";
 export { createMcpHttpApp, createMcpServer, startMcpServerStdio };

package/dist/{pricing-fetcher-ZrH9X6Xp.js → pricing-fetcher-DzkXdtDF.js}

@@ -1,5 +1,5 @@
 import { modelPricingSchema } from "./_types-C0oFKDO-.js";
-import { logger } from "./logger-L_zzb0iT.js";
+import { logger } from "./logger-QcakA1fc.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import F, { homedir } from "node:os";

package/dist/pricing-fetcher.js

@@ -1,4 +1,4 @@
-import { PricingFetcher } from "./pricing-fetcher-ZrH9X6Xp.js";
+import { PricingFetcher } from "./pricing-fetcher-DzkXdtDF.js";
 import "./_types-C0oFKDO-.js";
-import "./logger-L_zzb0iT.js";
+import "./logger-QcakA1fc.js";
 export { PricingFetcher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccusage",
-  "version": "15.9.3",
+  "version": "15.9.4",
   "description": "Usage analysis tool for Claude Code",
   "homepage": "https://github.com/ryoppippi/ccusage#readme",
   "bugs": {