ccusage 0.3.1 → 0.4.0

package/README.md

@@ -46,6 +46,16 @@ This tool helps you understand the value you're getting from your subscription b
 - 💰 **Cost Tracking**: Shows costs in USD for each day/session
 - 🔄 **Cache Token Support**: Tracks and displays cache creation and cache read tokens separately
 
+## Important Disclaimer
+
+⚠️ **This is NOT an official Claude tool** - it's an independent community project that analyzes locally stored usage data.
+
+**Cost calculations are estimates only** and may not reflect actual billing:
+- Costs shown are virtual/estimated based on token counts and model pricing data
+- Actual costs may vary due to pricing changes, special rates, or billing adjustments
+- We do not guarantee the accuracy of calculated costs
+- For official billing information, always refer to your Claude account dashboard
+
 ## Limitations
 
 - This tool only reads local JSONL files generated by Claude Code. If you use Claude Code with multiple devices, you need to ensure the JSONL files are synchronized across devices.
@@ -113,6 +123,11 @@ ccusage daily --path /custom/path/to/.claude
 
 # Output in JSON format
 ccusage daily --json
+
+# Control cost calculation mode
+ccusage daily --mode auto       # Use costUSD when available, calculate otherwise (default)
+ccusage daily --mode calculate  # Always calculate costs from tokens
+ccusage daily --mode display    # Always show pre-calculated costUSD values
 ```
 
 `ccusage` is an alias for `ccusage daily`, so you can run it without specifying the subcommand.
@@ -133,6 +148,11 @@ ccusage session --since 20250525 --until 20250530 --path /custom/path
 
 # Output in JSON format
 ccusage session --json
+
+# Control cost calculation mode
+ccusage session --mode auto       # Use costUSD when available, calculate otherwise (default)
+ccusage session --mode calculate  # Always calculate costs from tokens
+ccusage session --mode display    # Always show pre-calculated costUSD values
 ```
 
 ### Options
@@ -143,9 +163,18 @@ All commands support the following options:
 - `-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`
+- `-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
 - `-v, --version`: Display version
 
+#### Cost Calculation Modes
+
+- **`auto`** (default): Uses pre-calculated `costUSD` values when available, falls back to calculating costs from token counts using model pricing
+- **`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
+
 ## Output Example
 
 ### Daily Report

package/dist/calculate-cost.d.ts

@@ -1,22 +1,5 @@
-import { DailyUsage, SessionUsage } from "./data-loader-Ds_vUoR2.js";
-import "valibot";
+import { DailyUsage, SessionUsage, TokenData, TokenTotals } from "./data-loader-D1LHcGfa.js";
 
-//#region types.d.ts
-
-interface TokenTotals {
-  inputTokens: number;
-  outputTokens: number;
-  cacheCreationTokens: number;
-  cacheReadTokens: number;
-  totalCost: number;
-}
-interface TokenData {
-  inputTokens: number;
-  outputTokens: number;
-  cacheCreationTokens: number;
-  cacheReadTokens: number;
-}
-//#endregion
 //#region calculate-cost.d.ts
 declare function calculateTotals(data: Array<DailyUsage | SessionUsage>): TokenTotals;
 declare function getTotalTokens(tokens: TokenData): number;