ccusage 0.8.0 → 9.0.1

package/README.md

@@ -45,10 +45,12 @@ This tool helps you understand the value you're getting from your subscription b
 - 📊 **Model Breakdown**: View per-model cost breakdown with `--breakdown` flag
 - 📅 **Date Filtering**: Filter reports by date range using `--since` and `--until`
 - 📁 **Custom Path**: Support for custom Claude data directory locations
-- 🎨 **Beautiful Output**: Colorful table-formatted display
+- 🎨 **Beautiful Output**: Colorful table-formatted display with responsive width adjustment
 - 📄 **JSON Output**: Export data in structured JSON format with `--json`
 - 💰 **Cost Tracking**: Shows costs in USD for each day/month/session
 - 🔄 **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
 
 ## Important Disclaimer
 
@@ -129,8 +131,9 @@ ccusage daily
 # Filter by date range
 ccusage daily --since 20250525 --until 20250530
 
-# Use custom Claude data directory
-ccusage daily --path /custom/path/to/.claude
+# Set CLAUDE_CONFIG_DIR environment variable for custom data directory
+export CLAUDE_CONFIG_DIR="/custom/path/to/.claude"
+ccusage daily
 
 # Output in JSON format
 ccusage daily --json
@@ -146,6 +149,10 @@ ccusage daily --order desc      # Show newest dates first (default)
 
 # Show per-model cost breakdown
 ccusage daily --breakdown       # Show cost breakdown by model (opus-4, sonnet-4, etc.)
+
+# Use offline mode (no network required)
+ccusage daily --offline         # Use pre-cached pricing data
+ccusage daily -O                # Short alias for --offline
 ```
 
 `ccusage` is an alias for `ccusage daily`, so you can run it without specifying the subcommand.
@@ -164,6 +171,10 @@ ccusage monthly --since 20250101 --until 20250531
 # Use custom Claude data directory
 ccusage monthly --path /custom/path/to/.claude
 
+# Or set CLAUDE_CONFIG_DIR environment variable
+export CLAUDE_CONFIG_DIR="/custom/path/to/.claude"
+ccusage monthly
+
 # Output in JSON format
 ccusage monthly --json
 
@@ -178,6 +189,10 @@ ccusage monthly --order desc      # Show newest months first (default)
 
 # Show per-model cost breakdown
 ccusage monthly --breakdown       # Show cost breakdown by model
+
+# Use offline mode (no network required)
+ccusage monthly --offline         # Use pre-cached pricing data
+ccusage monthly -O                # Short alias for --offline
 ```
 
 ### Session Report
@@ -191,8 +206,9 @@ ccusage session
 # Filter sessions by last activity date
 ccusage session --since 20250525
 
-# Combine filters
-ccusage session --since 20250525 --until 20250530 --path /custom/path
+# Combine filters with environment variable
+export CLAUDE_CONFIG_DIR="/custom/path"
+ccusage session --since 20250525 --until 20250530
 
 # Output in JSON format
 ccusage session --json
@@ -208,6 +224,10 @@ ccusage session --order desc      # Show newest sessions first (default)
 
 # Show per-model cost breakdown
 ccusage session --breakdown       # Show cost breakdown by model
+
+# Use offline mode (no network required)
+ccusage session --offline         # Use pre-cached pricing data
+ccusage session -O                # Short alias for --offline
 ```
 
 ### Options
@@ -216,11 +236,11 @@ All commands support the following options:
 
 - `-s, --since <date>`: Filter from date (YYYYMMDD format)
 - `-u, --until <date>`: Filter until date (YYYYMMDD format)
-- `-p, --path <path>`: Custom path to Claude data directory (default: `~/.claude`)
 - `-j, --json`: Output results in JSON format instead of table
 - `-m, --mode <mode>`: Cost calculation mode: `auto` (default), `calculate`, or `display`
 - `-o, --order <order>`: Sort order: `desc` (newest first, default) or `asc` (oldest first).
 - `-b, --breakdown`: Show per-model cost breakdown (splits usage by Opus, Sonnet, etc.)
+- `-O, --offline`: Use pre-cached pricing data for Claude models (no network connection required)
 - `-d, --debug`: Show pricing mismatch information for debugging
 - `--debug-samples <number>`: Number of sample discrepancies to show in debug output (default: 5)
 - `-h, --help`: Display help message
@@ -232,6 +252,21 @@ All commands support the following options:
 - **`calculate`**: Always calculates costs from token counts using model pricing, ignores any pre-calculated `costUSD` values
 - **`display`**: Always uses pre-calculated `costUSD` values only, shows $0.00 for entries without pre-calculated costs
 
+#### Environment Variable Support
+
+The tool supports the `CLAUDE_CONFIG_DIR` environment variable to specify the Claude data directory:
+
+```bash
+# Set the environment variable to use a custom Claude directory
+export CLAUDE_CONFIG_DIR="/path/to/custom/claude/directory"
+ccusage daily
+
+# The environment variable determines the Claude data directory
+ccusage daily
+```
+
+The tool will use the path specified in the `CLAUDE_CONFIG_DIR` environment variable, or fall back to the default `~/.claude` directory if not set.
+
 ### MCP (Model Context Protocol) Support
 
 Exposes usage data through Model Context Protocol for integration with other tools:

package/dist/calculate-cost.d.ts

@@ -1,5 +1,5 @@
-import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-amTZCtBR.js";
-import "./pricing-fetcher-Dq-OLBp4.js";
+import "./pricing-fetcher-BkSZh4lR.js";
+import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-OGaMjZTD.js";
 
 //#region src/calculate-cost.d.ts
 type TokenData = {

package/dist/chunk-BLXvPPr8.js

@@ -0,0 +1,30 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __commonJS, __require, __toESM };