llm-usage-metrics 0.5.2 → 0.7.0

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`.
 
@@ -98,6 +99,8 @@ llm-usage monthly --per-model-columns
 llm-usage monthly --share
 ```
 
+Usage tables rank per-period model breakdowns by total tokens so the dominant models appear first in terminal and Markdown output.
+
 ### Trends
 
 ```bash
@@ -152,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
 
@@ -175,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
@@ -187,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
 ```
 
@@ -346,9 +351,15 @@ pnpm cli daily
 - **[Optimize](https://ayagmar.github.io/llm-usage-metrics/optimize/)** — Counterfactual candidate-model pricing semantics
 - **[Data Sources](https://ayagmar.github.io/llm-usage-metrics/sources/)** — Source configuration
 - **[Configuration](https://ayagmar.github.io/llm-usage-metrics/configuration/)** — Environment variables
+- **[Security](https://ayagmar.github.io/llm-usage-metrics/security/)** — Current security controls, dependency hygiene, and contributor steps
 - **[Benchmarks](https://ayagmar.github.io/llm-usage-metrics/benchmarks/)** — Production benchmark methodology and results
 - **[Architecture](https://ayagmar.github.io/llm-usage-metrics/architecture/)** — Technical overview
 
+## 🔐 Security
+
+Current repo protections include exact direct dependency pins, frozen-lockfile installs in CI, committed lockfile integrity hashes, SHA-pinned GitHub Actions, Dependabot for dependency and workflow updates, dedicated security workflows (`pnpm audit`, Dependency Review, and CodeQL), and OIDC-based npm trusted publishing.
+See the full security guide: **[Security](https://ayagmar.github.io/llm-usage-metrics/security/)**.
+
 ## 🤝 Contributing
 
 Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.