ccusage 14.1.2 → 15.0.1

package/README.md

@@ -15,6 +15,10 @@
     <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/screenshot.png">
 </div>
 
+<div align="center">
+    <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/blocks-live.png">
+</div>
+
 > **ccusage(claude-code-usage)**
 
 A CLI tool for analyzing Claude Code usage from local JSONL files.
@@ -48,6 +52,7 @@ This tool helps you understand the value you're getting from your subscription b
 - 📅 **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
+- 📈 **Live Monitoring**: Real-time dashboard showing active session progress, token burn rate, and cost projections with `blocks --live`
 - 🤖 **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`
@@ -284,6 +289,13 @@ ccusage blocks -t 500000
 # Use the highest previous block as the token limit
 ccusage blocks -t max
 
+# Live monitoring dashboard with real-time updates
+ccusage blocks --live # automatically uses highest previous session as token limit (-t max)
+ccusage blocks --live -t 500000  # with explicit token limit (500,000 tokens)
+ccusage blocks --live -t max     # explicitly use highest previous session limit
+ccusage blocks --live --refresh-interval 5  # update every 5 seconds (default: 1s)
+ccusage blocks --live -t 1000000 --refresh-interval 2  # 1M token limit, 2s refresh
+
 # Combine options
 ccusage blocks --recent -t max
 
@@ -307,11 +319,23 @@ The blocks report helps you understand Claude Code's 5-hour rolling session wind
 - Helps track if you're approaching token limits within a session
 - The `-t max` option automatically uses your highest previous block as the limit
 
+**Live Monitoring Features:**
+
+- Real-time dashboard updates every 1 second (configurable 1-60s)
+- Automatic token limit detection from your usage history
+- Session progress bar with time remaining and burn rate
+- Cost projections based on current usage patterns
+- Colorful progress indicators (green/yellow/red for quota warnings)
+- Graceful shutdown with Ctrl+C
+
 #### Blocks-specific options
 
 - `-t, --token-limit <number|max>`: Set token limit for quota warnings (use "max" for highest previous block)
 - `-a, --active`: Show only active block with detailed projections
 - `-r, --recent`: Show blocks from last 3 days (including active)
+- `-l, --session-length <hours>`: Session block duration in hours (default: 5)
+- `--live`: Live monitoring mode with real-time dashboard (automatically uses `-t max` and shows active block only)
+- `--refresh-interval <seconds>`: Refresh interval for live mode (default: 1, range: 1-60)
 
 ### Options
 
@@ -565,6 +589,7 @@ some projects use `ccusage` internally and provide additional features:
 
 - [claude-usage-tracker-for-mac](https://github.com/penicillin0/claude-usage-tracker-for-mac) – macOS menu bar app to visualize Claude Code usage costs by [@penicillin0](https://github.com/penicillin0).
 - [ccusage Raycast Extension](https://www.raycast.com/nyatinte/ccusage) – Raycast extension to view Claude Code usage reports in Raycast by [@nyatinte](https://github.com/nyatinte).
+- [ClaudeCode_Dashboard](https://github.com/m-sigepon/ClaudeCode_Dashboard) – Web dashboard to visualize Claude Code usage with charts and USD/JPY conversion by [@m-sigepon](https://github.com/m-sigepon).
 
 ## Acknowledgments
 
@@ -574,7 +599,7 @@ Thanks to [@milliondev](https://note.com/milliondev) for the original concept an
 
 <p align="center">
     <a href="https://github.com/sponsors/ryoppippi">
-        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/sponsors/sponsors.svg">
+        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/sponsors@main/sponsors.svg">
     </a>
 </p>
 

package/dist/calculate-cost.d.ts

@@ -1,5 +1,5 @@
 import "./pricing-fetcher-CXnYw4TA.js";
-import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-C1n0ww95.js";
+import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-Bll0wMdK.js";
 
 //#region src/calculate-cost.d.ts
 /**

package/dist/{data-loader-C1n0ww95.d.ts → data-loader-Bll0wMdK.d.ts}

@@ -91,8 +91,8 @@ declare const usageDataSchema: z.ZodObject<{
       cache_creation_input_tokens?: number | undefined;
       cache_read_input_tokens?: number | undefined;
     };
-    model?: string & z.BRAND<"ModelName"> | undefined;
-    id?: string & z.BRAND<"MessageId"> | undefined;
+    model?: (string & z.BRAND<"ModelName">) | undefined;
+    id?: (string & z.BRAND<"MessageId">) | undefined;
   }, {
     usage: {
       input_tokens: number;
@@ -107,7 +107,7 @@ declare const usageDataSchema: z.ZodObject<{
   requestId: z.ZodOptional<z.ZodBranded<z.ZodString, "RequestId">>;
 }, "strip", z.ZodTypeAny, {
   timestamp: string & z.BRAND<"ISOTimestamp">;
-  version?: string & z.BRAND<"Version"> | undefined;
+  version?: (string & z.BRAND<"Version">) | undefined;
   message: {
     usage: {
       input_tokens: number;
@@ -115,11 +115,11 @@ declare const usageDataSchema: z.ZodObject<{
       cache_creation_input_tokens?: number | undefined;
       cache_read_input_tokens?: number | undefined;
     };
-    model?: string & z.BRAND<"ModelName"> | undefined;
-    id?: string & z.BRAND<"MessageId"> | undefined;
+    model?: (string & z.BRAND<"ModelName">) | undefined;
+    id?: (string & z.BRAND<"MessageId">) | undefined;
   };
   costUSD?: number | undefined;
-  requestId?: string & z.BRAND<"RequestId"> | undefined;
+  requestId?: (string & z.BRAND<"RequestId">) | undefined;
 }, {
   timestamp: string;
   version?: string | undefined;

package/dist/{data-loader-BFS_JSqd.js → data-loader-DQftfBz9.js}

@@ -1,6 +1,6 @@
-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, require_usingCtx } from "./pricing-fetcher-XdvIG0to.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, require_usingCtx } from "./pricing-fetcher-DBzWmU38.js";
 import { activityDateSchema, arrayType, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, dailyDateSchema, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, numberType, objectType, projectPathSchema, requestIdSchema, sessionIdSchema, versionSchema } from "./_types-Cr2YEzKm.js";
-import { logger } from "./logger-CIYlc309.js";
+import { logger } from "./logger-r_DhIB_J.js";
 import a, { readFile } from "node:fs/promises";
 import F, { homedir } from "node:os";
 import path, { posix } from "node:path";
@@ -3065,6 +3065,16 @@ async function glob(patternsOrOptions, options) {
 */
 const DEFAULT_SESSION_DURATION_HOURS = 5;
 /**
+* Floors a timestamp to the beginning of the hour in UTC
+* @param timestamp - The timestamp to floor
+* @returns New Date object floored to the UTC hour
+*/
+function floorToHour(timestamp) {
+	const floored = new Date(timestamp);
+	floored.setUTCMinutes(0, 0, 0);
+	return floored;
+}
+/**
 * Identifies and creates session blocks from usage entries
 * Groups entries into time-based blocks (typically 5-hour periods) with gap detection
 * @param entries - Array of usage entries to process
@@ -3082,7 +3092,7 @@ function identifySessionBlocks(entries, sessionDurationHours = DEFAULT_SESSION_D
 	for (const entry of sortedEntries) {
 		const entryTime = entry.timestamp;
 		if (currentBlockStart == null) {
-			currentBlockStart = entryTime;
+			currentBlockStart = floorToHour(entryTime);
 			currentBlockEntries = [entry];
 		} else {
 			const timeSinceBlockStart = entryTime.getTime() - currentBlockStart.getTime();
@@ -3097,7 +3107,7 @@ function identifySessionBlocks(entries, sessionDurationHours = DEFAULT_SESSION_D
 					const gapBlock = createGapBlock(lastEntryTime, entryTime, sessionDurationMs);
 					if (gapBlock != null) blocks.push(gapBlock);
 				}
-				currentBlockStart = entryTime;
+				currentBlockStart = floorToHour(entryTime);
 				currentBlockEntries = [entry];
 			} else currentBlockEntries.push(entry);
 		}
@@ -3869,4 +3879,4 @@ async function loadSessionBlockData(options) {
 		_usingCtx4.d();
 	}
 }
-export { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, dailyUsageSchema, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, glob, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, uniq, usageDataSchema };
+export { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, dailyUsageSchema, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, glob, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, uniq, usageDataSchema };

package/dist/data-loader.d.ts

@@ -1,3 +1,3 @@
 import "./pricing-fetcher-CXnYw4TA.js";
-import { DailyUsage, DateFilter, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-C1n0ww95.js";
+import { DailyUsage, DateFilter, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-Bll0wMdK.js";
 export { DailyUsage, DateFilter, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };

package/dist/data-loader.js

@@ -1,5 +1,5 @@
-import "./pricing-fetcher-XdvIG0to.js";
+import "./pricing-fetcher-DBzWmU38.js";
 import "./_types-Cr2YEzKm.js";
-import { calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-BFS_JSqd.js";
-import "./logger-CIYlc309.js";
+import { calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-DQftfBz9.js";
+import "./logger-r_DhIB_J.js";
 export { calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getClaudePaths, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };

package/dist/{debug-DIfzQVQt.js → debug-CXtWvV0a.js}

@@ -1,6 +1,6 @@
-import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, require_usingCtx } from "./pricing-fetcher-XdvIG0to.js";
-import { getDefaultClaudePath, glob, usageDataSchema } from "./data-loader-BFS_JSqd.js";
-import { logger } from "./logger-CIYlc309.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, require_usingCtx } from "./pricing-fetcher-DBzWmU38.js";
+import { getDefaultClaudePath, glob, usageDataSchema } from "./data-loader-DQftfBz9.js";
+import { logger } from "./logger-r_DhIB_J.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 var import_usingCtx = __toESM(require_usingCtx(), 1);

package/dist/debug.js

@@ -1,6 +1,6 @@
-import "./pricing-fetcher-XdvIG0to.js";
+import "./pricing-fetcher-DBzWmU38.js";
 import "./_types-Cr2YEzKm.js";
-import "./data-loader-BFS_JSqd.js";
-import "./logger-CIYlc309.js";
-import { detectMismatches, printMismatchReport } from "./debug-DIfzQVQt.js";
+import "./data-loader-DQftfBz9.js";
+import "./logger-r_DhIB_J.js";
+import { detectMismatches, printMismatchReport } from "./debug-CXtWvV0a.js";
 export { detectMismatches, printMismatchReport };