ccusage 15.10.0 → 16.0.0

package/dist/calculate-cost.d.ts

@@ -1,5 +1,5 @@
 import "./pricing-fetcher-BgDfBZ05.js";
-import { DailyUsage, MonthlyUsage, SessionUsage, WeeklyUsage } from "./data-loader-BJnD_oR3.js";
+import { DailyUsage, MonthlyUsage, SessionUsage, WeeklyUsage } from "./data-loader--Ga8BPdt.js";
 
 //#region src/_token-utils.d.ts
 

package/dist/{data-loader-BJnD_oR3.d.ts → data-loader--Ga8BPdt.d.ts}

@@ -7,6 +7,10 @@ import { z } from "zod";
  * Days of the week for weekly aggregation
  */
 declare const WEEK_DAYS: readonly ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+/**
+ * Default configuration file name for storing usage data
+ * Used to load and save configuration settings
+ */
 //#endregion
 //#region src/_session-blocks.d.ts
 /**

package/dist/{data-loader-Dhwqb-FE.js → data-loader-Bf4qMLf2.js}

@@ -1,7 +1,7 @@
-import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, CONTEXT_LOW_THRESHOLD_ENV, CONTEXT_MEDIUM_THRESHOLD_ENV, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, isSuccess, require_usingCtx } from "./pricing-fetcher-D3tIkxxO.js";
+import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, CONTEXT_LOW_THRESHOLD_ENV, CONTEXT_MEDIUM_THRESHOLD_ENV, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, isSuccess, require_usingCtx } from "./pricing-fetcher-CUQk_dDN.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-BbEk8t2a.js";
-import { logger } from "./logger-yNFB24CE.js";
+import { logger } from "./logger-ClcgjXEW.js";
 import a, { readFile } from "node:fs/promises";
 import path, { posix } from "node:path";
 import process$1 from "node:process";
@@ -2761,4 +2761,4 @@ async function loadSessionBlockData(options) {
 		_usingCtx6.d();
 	}
 }
-export { DEFAULT_SESSION_DURATION_HOURS, bucketUsageSchema, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, uniq, unwrap, usageDataSchema, weeklyUsageSchema };
+export { DEFAULT_SESSION_DURATION_HOURS, bucketUsageSchema, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, toArray, transcriptMessageSchema, transcriptUsageSchema, uniq, unwrap, usageDataSchema, weeklyUsageSchema };

package/dist/data-loader.d.ts

@@ -1,3 +1,3 @@
 import "./pricing-fetcher-BgDfBZ05.js";
-import { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-BJnD_oR3.js";
+import { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader--Ga8BPdt.js";
 export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/data-loader.js

@@ -1,6 +1,6 @@
-import "./pricing-fetcher-D3tIkxxO.js";
+import "./pricing-fetcher-CUQk_dDN.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-BbEk8t2a.js";
-import { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-Dhwqb-FE.js";
-import "./logger-yNFB24CE.js";
+import { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-Bf4qMLf2.js";
+import "./logger-ClcgjXEW.js";
 export { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/{debug-DseOsUbb.js → debug-Oi3WqR-w.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-D3tIkxxO.js";
-import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-Dhwqb-FE.js";
-import { logger } from "./logger-yNFB24CE.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-CUQk_dDN.js";
+import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-Bf4qMLf2.js";
+import { logger } from "./logger-ClcgjXEW.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-D3tIkxxO.js";
+import "./pricing-fetcher-CUQk_dDN.js";
 import "./_token-utils-WjkbrjKv.js";
 import "./_types-BbEk8t2a.js";
-import "./data-loader-Dhwqb-FE.js";
-import "./logger-yNFB24CE.js";
-import { detectMismatches, printMismatchReport } from "./debug-DseOsUbb.js";
+import "./data-loader-Bf4qMLf2.js";
+import "./logger-ClcgjXEW.js";
+import { detectMismatches, printMismatchReport } from "./debug-Oi3WqR-w.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, inspectError, isFailure, isSuccess, map, pipe, require_usingCtx, succeed, try_ } from "./pricing-fetcher-D3tIkxxO.js";
+import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, CONFIG_FILE_NAME, 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, inspect, inspectError, isFailure, isSuccess, map, pipe, require_usingCtx, succeed, try_ } from "./pricing-fetcher-CUQk_dDN.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
 import { CostModes, SortOrders, filterDateSchema, statuslineHookJsonSchema } from "./_types-BbEk8t2a.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
-import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, uniq, unwrap, usageDataSchema } from "./data-loader-Dhwqb-FE.js";
-import { description, log, logger, name, version } from "./logger-yNFB24CE.js";
-import { detectMismatches, printMismatchReport } from "./debug-DseOsUbb.js";
-import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-Cfnsg0lJ.js";
+import { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, filterRecentBlocks, formatDateCompact, getClaudePaths, getContextUsageThresholds, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, projectBlockUsage, sortFilesByTimestamp, toArray, uniq, unwrap, usageDataSchema } from "./data-loader-Bf4qMLf2.js";
+import { description, log, logger, name, version } from "./logger-ClcgjXEW.js";
+import { detectMismatches, printMismatchReport } from "./debug-Oi3WqR-w.js";
+import { createMcpHttpApp, createMcpServer, startMcpServerStdio } from "./mcp-DW2TXqtN.js";
 import a, { readFile, stat } from "node:fs/promises";
 import path, { join } from "node:path";
 import process$1 from "node:process";
@@ -817,7 +817,94 @@ var require_picocolors = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		};
 	};
 	module.exports = createColors(), module.exports.createColors = createColors;
-})), import_picocolors$8 = /* @__PURE__ */ __toESM(require_picocolors(), 1);
+})), import_picocolors$8 = /* @__PURE__ */ __toESM(require_picocolors(), 1), import_usingCtx$3 = /* @__PURE__ */ __toESM(require_usingCtx(), 1);
+function extractExplicitArgs(tokens) {
+	const explicit = {};
+	for (const token of tokens) if (typeof token === "object" && token !== null) {
+		const t = token;
+		if (t.kind === "option" && typeof t.name === "string") explicit[t.name] = true;
+	}
+	return explicit;
+}
+function getConfigSearchPaths() {
+	const claudeConfigDirs = [join(process$1.cwd(), ".ccusage"), ...toArray(getClaudePaths())];
+	return claudeConfigDirs.map((dir) => join(dir, CONFIG_FILE_NAME));
+}
+function validateConfigJson(data) {
+	if (typeof data !== "object" || data === null) return false;
+	const config = data;
+	return !(config.$schema != null && typeof config.$schema !== "string" || config.defaults != null && (typeof config.defaults !== "object" || config.defaults === null) || config.commands != null && (typeof config.commands !== "object" || config.commands === null));
+}
+function loadConfigFile(filePath, debug$4 = false) {
+	if (!existsSync(filePath)) {
+		if (debug$4) logger.info(`  • Checking: ${filePath} (not found)`);
+		return void 0;
+	}
+	const parseConfigFileResult = pipe(try_({
+		try: () => {
+			const content = readFileSync(filePath, "utf-8"), data = JSON.parse(content);
+			if (!validateConfigJson(data)) throw new Error("Invalid configuration structure");
+			return data.source = filePath, data;
+		},
+		catch: (error) => error
+	})(), inspect(() => {
+		if (logger.debug(`Parsed configuration file: ${filePath}`), debug$4) logger.info(`  • Checking: ${filePath} (found ✓)`);
+	}), inspectError((error) => {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		if (logger.warn(`Error parsing configuration file at ${filePath}: ${errorMessage}`), debug$4) logger.info(`  • Checking: ${filePath} (error: ${errorMessage})`);
+	}), unwrap(void 0));
+	return parseConfigFileResult;
+}
+function loadConfig(configPath, debug$4 = false) {
+	if (debug$4) logger.info("Debug mode enabled - showing config loading details\n");
+	if (configPath != null) {
+		if (debug$4) logger.info("Using specified config file:"), logger.info(`  • Path: ${configPath}`);
+		const config = loadConfigFile(configPath, debug$4);
+		if (config == null) logger.warn(`Configuration file not found or invalid: ${configPath}`);
+		else if (debug$4) logger.info(""), logger.info(`Loaded config from: ${configPath}`), logger.info(`  • Schema: ${config.$schema ?? "none"}`), logger.info(`  • Has defaults: ${config.defaults != null ? "yes" : "no"}${config.defaults != null ? ` (${Object.keys(config.defaults).length} options)` : ""}`), logger.info(`  • Has command configs: ${config.commands != null ? "yes" : "no"}${config.commands != null ? ` (${Object.keys(config.commands).join(", ")})` : ""}`);
+		return config;
+	}
+	if (debug$4) logger.info("Searching for config files:");
+	for (const searchPath of getConfigSearchPaths()) {
+		const config = loadConfigFile(searchPath, debug$4);
+		if (config != null) {
+			if (debug$4) logger.info(""), logger.info(`Loaded config from: ${searchPath}`), logger.info(`  • Schema: ${config.$schema ?? "none"}`), logger.info(`  • Has defaults: ${config.defaults != null ? "yes" : "no"}${config.defaults != null ? ` (${Object.keys(config.defaults).length} options)` : ""}`), logger.info(`  • Has command configs: ${config.commands != null ? "yes" : "no"}${config.commands != null ? ` (${Object.keys(config.commands).join(", ")})` : ""}`);
+			return config;
+		}
+	}
+	if (logger.debug("No valid configuration file found"), debug$4) logger.info(""), logger.info("No valid configuration file found");
+	return void 0;
+}
+function mergeConfigWithArgs(ctx, config, debug$4 = false) {
+	if (config == null) {
+		if (debug$4) logger.info(""), logger.info(`No config file loaded, using CLI args only for '${ctx.name ?? "unknown"}' command`);
+		return ctx.values;
+	}
+	const merged = {}, commandName = ctx.name, sources = {};
+	if (config.defaults != null) for (const [key, value$1] of Object.entries(config.defaults)) merged[key] = value$1, sources[key] = "defaults";
+	if (commandName != null && config.commands?.[commandName] != null) for (const [key, value$1] of Object.entries(config.commands[commandName])) merged[key] = value$1, sources[key] = "command config";
+	const explicit = extractExplicitArgs(ctx.tokens);
+	for (const [key, value$1] of Object.entries(ctx.values)) if (value$1 != null && explicit[key] === true) merged[key] = value$1, sources[key] = "CLI";
+	if (logger.debug(`Merged config for ${commandName ?? "unknown"}:`, merged), debug$4) {
+		logger.info(""), logger.info(`Merging options for '${commandName ?? "unknown"}' command:`);
+		const bySource = {
+			"defaults": [],
+			"command config": [],
+			"CLI": []
+		};
+		for (const [key, source] of Object.entries(sources)) if (bySource[source] != null) bySource[source].push(`${key}=${JSON.stringify(merged[key])}`);
+		if (bySource.defaults.length > 0) logger.info(`  • From defaults: ${bySource.defaults.join(", ")}`);
+		if (bySource["command config"].length > 0) logger.info(`  • From command config: ${bySource["command config"].join(", ")}`);
+		if (bySource.CLI.length > 0) logger.info(`  • From CLI args: ${bySource.CLI.join(", ")}`);
+		logger.info("  • Final merged options: {");
+		for (const [key, value$1] of Object.entries(merged)) {
+			const source = sources[key] ?? "unknown";
+			logger.info(`      ${key}: ${JSON.stringify(value$1)} (from ${source}),`);
+		}
+		logger.info("    }");
+	}
+	return merged;
+}
 const getContext = (raw) => ({
 	start: process$1.hrtime.bigint(),
 	command: raw.map((part) => getCommandPart(stripVTControlCharacters(part))).join(" "),
@@ -1077,6 +1164,10 @@ const sharedArgs = {
 		short: "q",
 		description: "Process JSON output with jq command (requires jq binary, implies --json)"
 	},
+	config: {
+		type: "string",
+		description: "Path to configuration file (default: auto-discovery)"
+	},
 	compact: {
 		type: "boolean",
 		description: "Force compact mode for narrow displays (better for screenshots)",
@@ -3072,7 +3163,7 @@ const blocksCommand = define({
 	},
 	toKebab: true,
 	async run(ctx) {
-		const useJson = ctx.values.json || ctx.values.jq != null;
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), useJson = mergedOptions.json || mergedOptions.jq != null;
 		if (useJson) logger.level = 0;
 		if (ctx.values.sessionLength <= 0) logger.error("Session length must be a positive number"), process$1.exit(1);
 		let blocks = await loadSessionBlockData({
@@ -3354,18 +3445,11 @@ const dailyCommand = define({
 		}
 	},
 	async run(ctx) {
-		const useJson = ctx.values.json || ctx.values.jq != null;
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), useJson = Boolean(mergedOptions.json) || mergedOptions.jq != null;
 		if (useJson) logger.level = 0;
 		const dailyData = await loadDailyUsageData({
-			since: ctx.values.since,
-			until: ctx.values.until,
-			mode: ctx.values.mode,
-			order: ctx.values.order,
-			offline: ctx.values.offline,
-			groupByProject: ctx.values.instances,
-			project: ctx.values.project,
-			timezone: ctx.values.timezone,
-			locale: ctx.values.locale
+			...mergedOptions,
+			groupByProject: mergedOptions.instances
 		});
 		if (dailyData.length === 0) {
 			if (useJson) log(JSON.stringify([]));
@@ -3373,12 +3457,12 @@ const dailyCommand = define({
 			process$1.exit(0);
 		}
 		const totals = calculateTotals(dailyData);
-		if (ctx.values.debug && !useJson) {
+		if (mergedOptions.debug && !useJson) {
 			const mismatchStats = await detectMismatches(void 0);
-			printMismatchReport(mismatchStats, ctx.values.debugSamples);
+			printMismatchReport(mismatchStats, mergedOptions.debugSamples);
 		}
 		if (useJson) {
-			const jsonOutput = ctx.values.instances && dailyData.some((d) => d.project != null) ? {
+			const jsonOutput = Boolean(mergedOptions.instances) && dailyData.some((d) => d.project != null) ? {
 				projects: groupByProject(dailyData),
 				totals: createTotalsObject(totals)
 			} : {
@@ -3396,8 +3480,8 @@ const dailyCommand = define({
 				})),
 				totals: createTotalsObject(totals)
 			};
-			if (ctx.values.jq != null) {
-				const jqResult = await processWithJq(jsonOutput, ctx.values.jq);
+			if (mergedOptions.jq != null) {
+				const jqResult = await processWithJq(jsonOutput, mergedOptions.jq);
 				if (isFailure(jqResult)) logger.error(jqResult.error.message), process$1.exit(1);
 				log(jqResult.value);
 			} else log(JSON.stringify(jsonOutput, null, 2));
@@ -3425,7 +3509,7 @@ const dailyCommand = define({
 					"right",
 					"right"
 				],
-				dateFormatter: (dateStr) => formatDateCompact(dateStr, ctx.values.timezone, ctx.values.locale),
+				dateFormatter: (dateStr) => formatDateCompact(dateStr, mergedOptions.timezone, mergedOptions.locale ?? void 0),
 				compactHead: [
 					"Date",
 					"Models",
@@ -3443,7 +3527,7 @@ const dailyCommand = define({
 				compactThreshold: 100,
 				forceCompact: ctx.values.compact
 			});
-			if (ctx.values.instances && dailyData.some((d) => d.project != null)) {
+			if (Boolean(mergedOptions.instances) && dailyData.some((d) => d.project != null)) {
 				const projectGroups = groupDataByProject(dailyData);
 				let isFirstProject = true;
 				for (const [projectName, projectData] of Object.entries(projectGroups)) {
@@ -3476,7 +3560,7 @@ const dailyCommand = define({
 						formatNumber(data.cacheReadTokens),
 						formatNumber(getTotalTokens(data)),
 						formatCurrency(data.totalCost)
-					]), ctx.values.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
+					]), mergedOptions.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
 					isFirstProject = false;
 				}
 			} else for (const data of dailyData) if (table.push([
@@ -3488,7 +3572,7 @@ const dailyCommand = define({
 				formatNumber(data.cacheReadTokens),
 				formatNumber(getTotalTokens(data)),
 				formatCurrency(data.totalCost)
-			]), ctx.values.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
+			]), mergedOptions.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
 			if (table.push([
 				"",
 				"",
@@ -3900,17 +3984,9 @@ const monthlyCommand = define({
 	description: "Show usage report grouped by month",
 	...sharedCommandConfig,
 	async run(ctx) {
-		const useJson = ctx.values.json || ctx.values.jq != null;
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), useJson = Boolean(mergedOptions.json) || mergedOptions.jq != null;
 		if (useJson) logger.level = 0;
-		const monthlyData = await loadMonthlyUsageData({
-			since: ctx.values.since,
-			until: ctx.values.until,
-			mode: ctx.values.mode,
-			order: ctx.values.order,
-			offline: ctx.values.offline,
-			timezone: ctx.values.timezone,
-			locale: ctx.values.locale
-		});
+		const monthlyData = await loadMonthlyUsageData(mergedOptions);
 		if (monthlyData.length === 0) {
 			if (useJson) {
 				const emptyOutput = {
@@ -3929,9 +4005,9 @@ const monthlyCommand = define({
 			process$1.exit(0);
 		}
 		const totals = calculateTotals(monthlyData);
-		if (ctx.values.debug && !useJson) {
+		if (mergedOptions.debug && !useJson) {
 			const mismatchStats = await detectMismatches(void 0);
-			printMismatchReport(mismatchStats, ctx.values.debugSamples);
+			printMismatchReport(mismatchStats, mergedOptions.debugSamples);
 		}
 		if (useJson) {
 			const jsonOutput = {
@@ -3948,8 +4024,8 @@ const monthlyCommand = define({
 				})),
 				totals: createTotalsObject(totals)
 			};
-			if (ctx.values.jq != null) {
-				const jqResult = await processWithJq(jsonOutput, ctx.values.jq);
+			if (mergedOptions.jq != null) {
+				const jqResult = await processWithJq(jsonOutput, mergedOptions.jq);
 				if (isFailure(jqResult)) logger.error(jqResult.error.message), process$1.exit(1);
 				log(jqResult.value);
 			} else log(JSON.stringify(jsonOutput, null, 2));
@@ -3977,7 +4053,7 @@ const monthlyCommand = define({
 					"right",
 					"right"
 				],
-				dateFormatter: (dateStr) => formatDateCompact(dateStr, ctx.values.timezone, ctx.values.locale),
+				dateFormatter: (dateStr) => formatDateCompact(dateStr, mergedOptions.timezone, mergedOptions.locale ?? "en-CA"),
 				compactHead: [
 					"Month",
 					"Models",
@@ -4004,7 +4080,7 @@ const monthlyCommand = define({
 				formatNumber(data.cacheReadTokens),
 				formatNumber(getTotalTokens(data)),
 				formatCurrency(data.totalCost)
-			]), ctx.values.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
+			]), mergedOptions.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
 			if (table.push([
 				"",
 				"",
@@ -4116,15 +4192,15 @@ const sessionCommand = define({
 	},
 	toKebab: true,
 	async run(ctx) {
-		const useJson = ctx.values.json || ctx.values.jq != null;
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), useJson = mergedOptions.json || mergedOptions.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"
+		if (mergedOptions.id != null) return handleSessionIdLookup({ values: {
+			id: mergedOptions.id,
+			mode: mergedOptions.mode,
+			offline: mergedOptions.offline,
+			jq: mergedOptions.jq,
+			timezone: mergedOptions.timezone,
+			locale: mergedOptions.locale ?? "en-CA"
 		} }, useJson);
 		const sessionData = await loadSessionData({
 			since: ctx.values.since,
@@ -5132,7 +5208,12 @@ function getSemaphore(sessionId) {
 	const semaphore = createLimoJson(semaphorePath);
 	return semaphore;
 }
-const statuslineCommand = define({
+const visualBurnRateChoices = [
+	"off",
+	"emoji",
+	"text",
+	"emoji-text"
+], statuslineCommand = define({
 	name: "statusline",
 	description: "Display compact status line for Claude Code hooks with hybrid time+file caching (Beta)",
 	toKebab: true,
@@ -5141,6 +5222,15 @@ const statuslineCommand = define({
 			...sharedArgs.offline,
 			default: true
 		},
+		visualBurnRate: {
+			type: "enum",
+			choices: visualBurnRateChoices,
+			description: "Controls the visualization of the burn rate status",
+			default: "off",
+			short: "vb",
+			negatable: false,
+			toKebab: true
+		},
 		cache: {
 			type: "boolean",
 			description: "Enable cache for status line output (default: true)",
@@ -5150,16 +5240,18 @@ const statuslineCommand = define({
 			type: "number",
 			description: `Refresh interval in seconds for cache expiry (default: ${DEFAULT_REFRESH_INTERVAL_SECONDS})`,
 			default: DEFAULT_REFRESH_INTERVAL_SECONDS
-		}
+		},
+		config: sharedArgs.config,
+		debug: sharedArgs.debug
 	},
 	async run(ctx) {
 		logger.level = 0;
-		const refreshInterval = ctx.values.refreshInterval, stdin$2 = await getStdin();
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), refreshInterval = mergedOptions.refreshInterval, stdin$2 = await getStdin();
 		if (stdin$2.length === 0) log("❌ No input provided"), process$1.exit(1);
 		const hookDataJson = JSON.parse(stdin$2.trim()), hookDataParseResult = statuslineHookJsonSchema.safeParse(hookDataJson);
 		if (!hookDataParseResult.success) log("❌ Invalid input format:", hookDataParseResult.error.message), process$1.exit(1);
 		const hookData = hookDataParseResult.data, sessionId = hookData.session_id, initialSemaphoreState = pipe(succeed(getSemaphore(sessionId)), map((semaphore) => semaphore.data), unwrap(void 0)), currentMtime = await getFileModifiedTime(hookData.transcript_path);
-		if (ctx.values.cache && initialSemaphoreState != null) {
+		if (mergedOptions.cache && initialSemaphoreState != null) {
 			const now = Date.now(), timeElapsed = now - (initialSemaphoreState.lastUpdateTime ?? 0), isExpired = timeElapsed >= refreshInterval * 1e3, isFileModified = initialSemaphoreState.transcriptMtime !== currentMtime;
 			if (!isExpired && !isFileModified) {
 				log(initialSemaphoreState.lastOutput);
@@ -5209,7 +5301,7 @@ const statuslineCommand = define({
 				const sessionCost = await pipe(try_({
 					try: loadSessionUsageById(sessionId, {
 						mode: "auto",
-						offline: ctx.values.offline
+						offline: mergedOptions.offline
 					}),
 					catch: (error) => error
 				}), map((sessionCost$1) => sessionCost$1?.totalCost), inspectError((error) => logger.error("Failed to load session data:", error)), unwrap(void 0)), today = /* @__PURE__ */ new Date(), todayStr = today.toISOString().split("T")[0]?.replace(/-/g, "") ?? "", todayCost = await pipe(try_({
@@ -5217,7 +5309,7 @@ const statuslineCommand = define({
 						since: todayStr,
 						until: todayStr,
 						mode: "auto",
-						offline: ctx.values.offline
+						offline: mergedOptions.offline
 					}),
 					catch: (error) => error
 				}), map((dailyData) => {
@@ -5229,7 +5321,7 @@ const statuslineCommand = define({
 				}), inspectError((error) => logger.error("Failed to load daily data:", error)), unwrap(0)), { blockInfo, burnRateInfo } = await pipe(try_({
 					try: loadSessionBlockData({
 						mode: "auto",
-						offline: ctx.values.offline
+						offline: mergedOptions.offline
 					}),
 					catch: (error) => error
 				}), map((blocks) => {
@@ -5242,8 +5334,26 @@ const statuslineCommand = define({
 					});
 					if (activeBlock != null) {
 						const now = /* @__PURE__ */ new Date(), remaining = Math.round((activeBlock.endTime.getTime() - now.getTime()) / (1e3 * 60)), blockCost = activeBlock.costUSD, blockInfo$1 = `${formatCurrency(blockCost)} block (${formatRemainingTime(remaining)})`, burnRate = calculateBurnRate(activeBlock), burnRateInfo$1 = burnRate != null ? (() => {
-							const costPerHour = burnRate.costPerHour, costPerHourStr = `${formatCurrency(costPerHour)}/hr`, coloredBurnRate = burnRate.tokensPerMinuteForIndicator < 2e3 ? import_picocolors$1.default.green(costPerHourStr) : burnRate.tokensPerMinuteForIndicator < 5e3 ? import_picocolors$1.default.yellow(costPerHourStr) : import_picocolors$1.default.red(costPerHourStr);
-							return ` | 🔥 ${coloredBurnRate}`;
+							const renderEmojiStatus = ctx.values.visualBurnRate === "emoji" || ctx.values.visualBurnRate === "emoji-text", renderTextStatus = ctx.values.visualBurnRate === "text" || ctx.values.visualBurnRate === "emoji-text", costPerHour = burnRate.costPerHour, costPerHourStr = `${formatCurrency(costPerHour)}/hr`, burnStatus = burnRate.tokensPerMinuteForIndicator < 2e3 ? "normal" : burnRate.tokensPerMinuteForIndicator < 5e3 ? "moderate" : "high", burnStatusMappings = {
+								normal: {
+									emoji: "🟢",
+									textValue: "Normal",
+									coloredString: import_picocolors$1.default.green
+								},
+								moderate: {
+									emoji: "⚠️",
+									textValue: "Moderate",
+									coloredString: import_picocolors$1.default.yellow
+								},
+								high: {
+									emoji: "🚨",
+									textValue: "High",
+									coloredString: import_picocolors$1.default.red
+								}
+							}, { emoji, textValue, coloredString } = burnStatusMappings[burnStatus], burnRateOutputSegments = [coloredString(costPerHourStr)];
+							if (renderEmojiStatus) burnRateOutputSegments.push(emoji);
+							if (renderTextStatus) burnRateOutputSegments.push(coloredString(`(${textValue})`));
+							return ` | 🔥 ${burnRateOutputSegments.join(" ")}`;
 						})() : "";
 						return {
 							blockInfo: blockInfo$1,
@@ -5258,7 +5368,7 @@ const statuslineCommand = define({
 					blockInfo: "No active block",
 					burnRateInfo: ""
 				})), contextInfo = await pipe(try_({
-					try: calculateContextTokens(hookData.transcript_path, hookData.model.id, ctx.values.offline),
+					try: calculateContextTokens(hookData.transcript_path, hookData.model.id, mergedOptions.offline),
 					catch: (error) => error
 				}), inspectError((error) => logger.debug(`Failed to calculate context tokens: ${error instanceof Error ? error.message : String(error)}`)), map((ctx$1) => {
 					if (ctx$1 == null) return void 0;
@@ -5272,7 +5382,7 @@ const statuslineCommand = define({
 		if (isSuccess(mainProcessingResult)) try {
 			var _usingCtx3 = (0, import_usingCtx.default)();
 			const statusLine = mainProcessingResult.value;
-			if (log(statusLine), !ctx.values.cache) return;
+			if (log(statusLine), !mergedOptions.cache) return;
 			const semaphore = _usingCtx3.u(getSemaphore(sessionId));
 			semaphore.data = {
 				date: (/* @__PURE__ */ new Date()).toISOString(),
@@ -5293,7 +5403,7 @@ const statuslineCommand = define({
 			var _usingCtx4 = (0, import_usingCtx.default)();
 			if (initialSemaphoreState?.lastOutput != null && initialSemaphoreState.lastOutput !== "") log(initialSemaphoreState.lastOutput);
 			else log("❌ Error generating status");
-			if (logger.error("Error in statusline command:", mainProcessingResult.error), !ctx.values.cache) return;
+			if (logger.error("Error in statusline command:", mainProcessingResult.error), !mergedOptions.cache) return;
 			const semaphore = _usingCtx4.u(getSemaphore(sessionId));
 			if (semaphore.data != null) semaphore.data.isUpdating = false, semaphore.data.pid = void 0;
 		} catch (_) {
@@ -5319,18 +5429,9 @@ const weeklyCommand = define({
 	},
 	toKebab: true,
 	async run(ctx) {
-		const useJson = ctx.values.json || ctx.values.jq != null;
+		const config = loadConfig(ctx.values.config, ctx.values.debug), mergedOptions = mergeConfigWithArgs(ctx, config, ctx.values.debug), useJson = Boolean(mergedOptions.json) || mergedOptions.jq != null;
 		if (useJson) logger.level = 0;
-		const weeklyData = await loadWeeklyUsageData({
-			since: ctx.values.since,
-			until: ctx.values.until,
-			timezone: ctx.values.timezone,
-			mode: ctx.values.mode,
-			order: ctx.values.order,
-			offline: ctx.values.offline,
-			startOfWeek: ctx.values.startOfWeek,
-			locale: ctx.values.locale
-		});
+		const weeklyData = await loadWeeklyUsageData(mergedOptions);
 		if (weeklyData.length === 0) {
 			if (useJson) {
 				const emptyOutput = {
@@ -5349,9 +5450,9 @@ const weeklyCommand = define({
 			process$1.exit(0);
 		}
 		const totals = calculateTotals(weeklyData);
-		if (ctx.values.debug && !useJson) {
+		if (mergedOptions.debug && !useJson) {
 			const mismatchStats = await detectMismatches(void 0);
-			printMismatchReport(mismatchStats, ctx.values.debugSamples);
+			printMismatchReport(mismatchStats, mergedOptions.debugSamples);
 		}
 		if (useJson) {
 			const jsonOutput = {
@@ -5368,8 +5469,8 @@ const weeklyCommand = define({
 				})),
 				totals: createTotalsObject(totals)
 			};
-			if (ctx.values.jq != null) {
-				const jqResult = await processWithJq(jsonOutput, ctx.values.jq);
+			if (mergedOptions.jq != null) {
+				const jqResult = await processWithJq(jsonOutput, mergedOptions.jq);
 				if (isFailure(jqResult)) logger.error(jqResult.error.message), process$1.exit(1);
 				log(jqResult.value);
 			} else log(JSON.stringify(jsonOutput, null, 2));
@@ -5397,7 +5498,7 @@ const weeklyCommand = define({
 					"right",
 					"right"
 				],
-				dateFormatter: (dateStr) => formatDateCompact(dateStr, ctx.values.timezone, ctx.values.locale),
+				dateFormatter: (dateStr) => formatDateCompact(dateStr, mergedOptions.timezone, mergedOptions.locale ?? void 0),
 				compactHead: [
 					"Week",
 					"Models",
@@ -5424,7 +5525,7 @@ const weeklyCommand = define({
 				formatNumber(data.cacheReadTokens),
 				formatNumber(getTotalTokens(data)),
 				formatCurrency(data.totalCost)
-			]), ctx.values.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
+			]), mergedOptions.breakdown) pushBreakdownRows(table, data.modelBreakdowns);
 			if (table.push([
 				"",
 				"",
@@ -5446,14 +5547,25 @@ const weeklyCommand = define({
 			]), log(table.toString()), table.isCompactMode()) logger.info("\nRunning in Compact Mode"), logger.info("Expand terminal width to see cache metrics and total tokens");
 		}
 	}
-}), subCommands = /* @__PURE__ */ new Map();
-subCommands.set("daily", dailyCommand), subCommands.set("monthly", monthlyCommand), subCommands.set("weekly", weeklyCommand), subCommands.set("session", sessionCommand), subCommands.set("blocks", blocksCommand), subCommands.set("mcp", mcpCommand), subCommands.set("statusline", statuslineCommand);
+}), subCommandUnion = [
+	["daily", dailyCommand],
+	["monthly", monthlyCommand],
+	["weekly", weeklyCommand],
+	["session", sessionCommand],
+	["blocks", blocksCommand],
+	["mcp", mcpCommand],
+	["statusline", statuslineCommand]
+], subCommands = /* @__PURE__ */ new Map();
+for (const [name$1, command] of subCommandUnion) subCommands.set(name$1, command);
 const mainCommand = dailyCommand;
-await cli(process$1.argv.slice(2), mainCommand, {
-	name,
-	version,
-	description,
-	subCommands,
-	renderHeader: null
-});
+async function run() {
+	await cli(process$1.argv.slice(2), mainCommand, {
+		name,
+		version,
+		description,
+		subCommands,
+		renderHeader: null
+	});
+}
+await run();
 export {};

package/dist/{logger-yNFB24CE.js → logger-ClcgjXEW.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.10.0", description = "Usage analysis tool for Claude Code";
+var name = "ccusage", version = "16.0.0", 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-yNFB24CE.js";
+import { log, logger } from "./logger-ClcgjXEW.js";
 export { log, logger };