ccusage 17.0.1 → 17.0.2

package/README.md

@@ -20,6 +20,20 @@
 
 > Analyze your Claude Code token usage and costs from local JSONL files — incredibly fast and informative!
 
+## ccusage Family
+
+### 📊 [ccusage](https://www.npmjs.com/package/ccusage) - Claude Code Usage Analyzer
+
+The main CLI tool for analyzing Claude Code usage from local JSONL files. Track daily, monthly, and session-based usage with beautiful tables and live monitoring.
+
+### 🤖 [@ccusage/codex](https://www.npmjs.com/package/@ccusage/codex) - OpenAI Codex Usage Analyzer
+
+Companion tool for analyzing OpenAI Codex usage. Same powerful features as ccusage but tailored for Codex users, including GPT-5 support and 1M token context windows.
+
+### 🔌 [@ccusage/mcp](https://www.npmjs.com/package/@ccusage/mcp) - MCP Server Integration
+
+Model Context Protocol server that exposes ccusage data to Claude Desktop and other MCP-compatible tools. Enable real-time usage tracking directly in your AI workflows.
+
 ## Installation
 
 ### Quick Start (Recommended)
@@ -27,17 +41,51 @@
 Thanks to ccusage's incredibly small bundle size ([![install size](https://packagephobia.com/badge?p=ccusage)](https://packagephobia.com/result?p=ccusage)), you can run it directly without installation:
 
 ```bash
-# Using bunx (recommended for speed)
+# Recommended - always include @latest to ensure you get the newest version
+npx ccusage@latest
 bunx ccusage
 
-# Using npx
-npx ccusage@latest
+# Alternative package runners
+pnpm dlx ccusage
+pnpx ccusage
 
 # Using deno (with security flags)
 deno run -E -R=$HOME/.claude/projects/ -S=homedir -N='raw.githubusercontent.com:443' npm:ccusage@latest
 ```
 
-> 💡 **Tip**: We recommend using `bunx` instead of `npx` for a massive speed improvement!
+> 💡 **Important**: We strongly recommend using `@latest` suffix with npx (e.g., `npx ccusage@latest`) to ensure you're running the most recent version with the latest features and bug fixes.
+
+### Related Tools
+
+#### Codex CLI
+
+Analyze OpenAI Codex usage with our companion tool [@ccusage/codex](https://www.npmjs.com/package/@ccusage/codex):
+
+```bash
+# Recommended - always include @latest
+npx @ccusage/codex@latest
+bunx @ccusage/codex@latest  # ⚠️ MUST include @latest with bunx
+
+# Alternative package runners
+pnpm dlx @ccusage/codex
+pnpx @ccusage/codex
+
+# Using deno (with security flags)
+deno run -E -R=$HOME/.codex/ -S=homedir -N='raw.githubusercontent.com:443' npm:@ccusage/codex@latest
+```
+
+> ⚠️ **Critical for bunx users**: Bun 1.2.x's bunx prioritizes binaries matching the package name suffix when given a scoped package. For `@ccusage/codex`, it looks for a `codex` binary in PATH first. If you have an existing `codex` command installed (e.g., GitHub Copilot's codex), that will be executed instead. **Always use `bunx @ccusage/codex@latest` with the version tag** to force bunx to fetch and run the correct package.
+
+#### MCP Server
+
+Integrate ccusage with Claude Desktop using [@ccusage/mcp](https://www.npmjs.com/package/@ccusage/mcp):
+
+```bash
+# Start MCP server for Claude Desktop integration
+npx @ccusage/mcp@latest --type http --port 8080
+```
+
+This enables real-time usage tracking and analysis directly within Claude Desktop conversations.
 
 ## Usage
 
@@ -68,9 +116,6 @@ npx ccusage daily --instances --project myproject --json  # Combined usage
 # Compact mode for screenshots/sharing
 npx ccusage --compact  # Force compact table mode
 npx ccusage monthly --compact  # Compact monthly report
-
-# MCP Server (Model Context Protocol)
-npx @ccusage/mcp@latest  # Run MCP server for Claude Desktop integration
 ```
 
 ## Features

package/dist/{data-loader-ClkEoCfz.js → data-loader-WR6J7qRb.js}

@@ -1,5 +1,5 @@
 import { activityDateSchema, array, boolean, createBucket, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, createWeeklyDate, dailyDateSchema, getTotalTokens, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, number, object, optional, parse as parse$2, projectPathSchema, requestIdSchema, safeParse, sessionIdSchema, string, union, versionSchema, weeklyDateSchema } from "./_types-CV6z8-9_.js";
-import { logger } from "./logger-C_yajNg2.js";
+import { logger } from "./logger-BPuFhmNp.js";
 import { createRequire } from "node:module";
 import a, { readFile, stat } from "node:fs/promises";
 import path, { basename, dirname, normalize, posix, relative, resolve, sep } from "node:path";

package/dist/data-loader.js

@@ -1,4 +1,4 @@
-import { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-ClkEoCfz.js";
+import { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema } from "./data-loader-WR6J7qRb.js";
 import "./_types-CV6z8-9_.js";
-import "./logger-C_yajNg2.js";
+import "./logger-BPuFhmNp.js";
 export { bucketUsageSchema, calculateContextTokens, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, transcriptMessageSchema, transcriptUsageSchema, usageDataSchema, weeklyUsageSchema };

package/dist/{debug-BQXAD_hV.js → debug-3XWYvoVQ.js}

@@ -1,6 +1,6 @@
-import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, _usingCtx, getClaudePaths, glob, isFailure, try_, unwrap, usageDataSchema } from "./data-loader-ClkEoCfz.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, _usingCtx, getClaudePaths, glob, isFailure, try_, unwrap, usageDataSchema } from "./data-loader-WR6J7qRb.js";
 import { safeParse } from "./_types-CV6z8-9_.js";
-import { logger } from "./logger-C_yajNg2.js";
+import { logger } from "./logger-BPuFhmNp.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 async function detectMismatches(claudePath) {

package/dist/debug.js

@@ -1,5 +1,5 @@
-import "./data-loader-ClkEoCfz.js";
+import "./data-loader-WR6J7qRb.js";
 import "./_types-CV6z8-9_.js";
-import "./logger-C_yajNg2.js";
-import { detectMismatches, printMismatchReport } from "./debug-BQXAD_hV.js";
+import "./logger-BPuFhmNp.js";
+import { detectMismatches, printMismatchReport } from "./debug-3XWYvoVQ.js";
 export { detectMismatches, printMismatchReport };

package/dist/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, CONFIG_FILE_NAME, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_LOCALE, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, DEFAULT_SESSION_DURATION_HOURS, MAX_REFRESH_INTERVAL_SECONDS, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, _usingCtx, andThen, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, fail, filterRecentBlocks, formatDateCompact, getClaudePaths, getEarliestTimestamp, getFileModifiedTime, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, inspect, inspectError, isFailure, isSuccess, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, map as map$2, pipe, projectBlockUsage, sortFilesByTimestamp, succeed, toArray, try_, uniq, unreachable, unwrap, usageDataSchema } from "./data-loader-ClkEoCfz.js";
+import { BLOCKS_COMPACT_WIDTH_THRESHOLD, BLOCKS_DEFAULT_TERMINAL_WIDTH, BLOCKS_WARNING_THRESHOLD, BURN_RATE_THRESHOLDS, CONFIG_FILE_NAME, DEFAULT_CONTEXT_USAGE_THRESHOLDS, DEFAULT_LOCALE, DEFAULT_RECENT_DAYS, DEFAULT_REFRESH_INTERVAL_SECONDS, DEFAULT_SESSION_DURATION_HOURS, MAX_REFRESH_INTERVAL_SECONDS, MIN_REFRESH_INTERVAL_SECONDS, MIN_RENDER_INTERVAL_MS, PricingFetcher, WEEK_DAYS, __commonJSMin, __require, __toESM, _usingCtx, andThen, calculateBurnRate, calculateContextTokens, calculateCostForEntry, createUniqueHash, fail, filterRecentBlocks, formatDateCompact, getClaudePaths, getEarliestTimestamp, getFileModifiedTime, getUsageLimitResetTime, globUsageFiles, identifySessionBlocks, inspect, inspectError, isFailure, isSuccess, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadSessionUsageById, loadWeeklyUsageData, map as map$2, pipe, projectBlockUsage, sortFilesByTimestamp, succeed, toArray, try_, uniq, unreachable, unwrap, usageDataSchema } from "./data-loader-WR6J7qRb.js";
 import { CostModes, SortOrders, check, filterDateSchema, flatten, getTotalTokens, integer as integer$1, maxValue, minValue, number, parse as parse$1, pipe as pipe$1, safeParse, statuslineHookJsonSchema, string, transform, trim, union } from "./_types-CV6z8-9_.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-CX9KwEZt.js";
-import { description, log, logger, name, version } from "./logger-C_yajNg2.js";
-import { detectMismatches, printMismatchReport } from "./debug-BQXAD_hV.js";
+import { description, log, logger, name, version } from "./logger-BPuFhmNp.js";
+import { detectMismatches, printMismatchReport } from "./debug-3XWYvoVQ.js";
 import a, { readFile, stat } from "node:fs/promises";
 import path, { join } from "node:path";
 import process$1 from "node:process";

package/dist/{logger-C_yajNg2.js → logger-BPuFhmNp.js}

@@ -869,7 +869,7 @@ function createLogger(name$1) {
 }
 const log = console.log;
 var name = "ccusage";
-var version = "17.0.1";
+var version = "17.0.2";
 var description = "Usage analysis tool for Claude Code";
 const logger = createLogger(name);
 const log$1 = log;

package/dist/logger.js

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

package/package.json

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