llm-usage-metrics 0.6.0 → 0.7.1

package/README.md

@@ -55,13 +55,14 @@ llm-usage daily
 
 ## 📋 Supported Sources
 
-| Source         | Pattern                                  | Discovery                        |
-| -------------- | ---------------------------------------- | -------------------------------- |
-| **pi**         | `~/.pi/agent/sessions/**/*.jsonl`        | Automatic                        |
-| **codex**      | `~/.codex/sessions/**/*.jsonl`           | Automatic                        |
-| **Gemini CLI** | `~/.gemini/tmp/*/chats/*.json`           | Automatic                        |
-| **Droid CLI**  | `~/.factory/sessions/**/*.settings.json` | Automatic                        |
-| **OpenCode**   | `~/.opencode/opencode.db`                | Auto or explicit `--opencode-db` |
+| Source          | Pattern                                  | Discovery                        |
+| --------------- | ---------------------------------------- | -------------------------------- |
+| **pi**          | `~/.pi/agent/sessions/**/*.jsonl`        | Automatic                        |
+| **codex**       | `~/.codex/sessions/**/*.jsonl`           | Automatic                        |
+| **Gemini CLI**  | `~/.gemini/tmp/*/chats/*.json`           | Automatic                        |
+| **Droid CLI**   | `~/.factory/sessions/**/*.settings.json` | Automatic                        |
+| **OpenCode**    | `~/.opencode/opencode.db`                | Auto or explicit `--opencode-db` |
+| **Claude Code** | `~/.claude/projects/**/*.jsonl`          | Automatic                        |
 
 OpenCode source support requires Node.js 24+ runtime with built-in `node:sqlite`.
 
@@ -154,9 +155,10 @@ llm-usage efficiency monthly --repo-dir /path/to/repo --source codex
 llm-usage efficiency monthly --repo-dir /path/to/repo --source gemini
 llm-usage efficiency monthly --repo-dir /path/to/repo --source droid
 llm-usage efficiency monthly --repo-dir /path/to/repo --source opencode
+llm-usage efficiency monthly --repo-dir /path/to/repo --source claude
 ```
 
-Note: usage filters (`--source`, `--provider`, `--model`, `--pi-dir`, `--codex-dir`, `--gemini-dir`, `--droid-dir`, `--opencode-db`, `--source-dir`) also constrain commit attribution: only commit days with matching repo-attributed usage events are counted.
+Note: usage filters (`--source`, `--provider`, `--model`, `--pi-dir`, `--codex-dir`, `--gemini-dir`, `--droid-dir`, `--claude-dir`, `--opencode-db`, `--source-dir`) also constrain commit attribution: only commit days with matching repo-attributed usage events are counted.
 
 ### Optimize Reports
 
@@ -177,7 +179,7 @@ llm-usage optimize monthly --provider openai --candidate-model gpt-4.1 --candida
 
 ```bash
 # By source
-llm-usage monthly --source pi,codex,gemini,droid
+llm-usage monthly --source pi,codex,gemini,droid,claude
 
 # By provider
 llm-usage monthly --provider openai
@@ -189,17 +191,18 @@ llm-usage monthly --model claude
 llm-usage monthly --source opencode --provider openai --model gpt-4.1
 ```
 
-Use `--source` to scope where events came from (`pi`, `codex`, `gemini`, `droid`, `opencode`), and `--provider` to scope the billing entity behind those events.
+Use `--source` to scope where events came from (`pi`, `codex`, `gemini`, `droid`, `opencode`, `claude`), and `--provider` to scope the billing entity behind those events.
 
 ### Custom Paths
 
 ```bash
 # Custom directories
-llm-usage daily --source-dir pi=/path/to/pi --source-dir codex=/path/to/codex --source-dir gemini=/path/to/.gemini --source-dir droid=/path/to/.factory/sessions
+llm-usage daily --source-dir pi=/path/to/pi --source-dir codex=/path/to/codex --source-dir gemini=/path/to/.gemini --source-dir droid=/path/to/.factory/sessions --source-dir claude=/path/to/.claude/projects
 
-# Explicit Gemini/Droid/OpenCode paths
+# Explicit Gemini/Droid/Claude/OpenCode paths
 llm-usage daily --gemini-dir /path/to/.gemini
 llm-usage daily --droid-dir /path/to/.factory/sessions
+llm-usage daily --claude-dir /path/to/.claude/projects
 llm-usage daily --opencode-db /path/to/opencode.db
 ```
 
@@ -211,6 +214,9 @@ llm-usage monthly --pricing-offline
 
 # Continue even if pricing fetch fails
 llm-usage monthly --ignore-pricing-failures
+
+# Override per-model pricing from a local JSON file
+llm-usage monthly --pricing-overrides ./pricing-overrides.json
 ```
 
 ## 🧪 Production Benchmarks
@@ -310,8 +316,8 @@ See full environment variable reference in the [documentation](https://ayagmar.g
 The CLI performs lightweight update checks with smart defaults:
 
 - 1-hour cache TTL
-- Fresh cached update results are used immediately
-- Stale or missing cache refreshes in the background instead of blocking report execution
+- Fresh cached update results are used immediately without any network call
+- Stale or missing cache triggers a bounded fetch (default 1s timeout) so the update prompt stays consistent across commands, instead of silently skipping the run that refreshes the cache
 - Skipped for `--help`, `--version`, `npx`, and direct source/development runs
 - Prompts only in interactive TTY sessions