llm-usage-metrics 0.3.3 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -11
- package/dist/index.js +377 -76
- package/dist/index.js.map +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -21,11 +21,11 @@
|
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
Aggregate token usage and costs from your local coding agent sessions. Supports **pi**, **codex**, and **OpenCode** with zero configuration required.
|
|
24
|
+
Aggregate token usage and costs from your local coding agent sessions. Supports **pi**, **codex**, **Gemini CLI**, and **OpenCode** with zero configuration required.
|
|
25
25
|
|
|
26
26
|
## ✨ Features
|
|
27
27
|
|
|
28
|
-
- **Zero-Config Discovery** — Automatically finds `.pi`, `.codex`, and OpenCode session data
|
|
28
|
+
- **Zero-Config Discovery** — Automatically finds `.pi`, `.codex`, `.gemini`, and OpenCode session data
|
|
29
29
|
- **LiteLLM Pricing** — Real-time pricing sync with offline caching support
|
|
30
30
|
- **Flexible Reports** — Daily, weekly, and monthly aggregations
|
|
31
31
|
- **Efficiency Reports** — Correlate cost/tokens with repository commit outcomes
|
|
@@ -53,11 +53,12 @@ llm-usage daily
|
|
|
53
53
|
|
|
54
54
|
## 📋 Supported Sources
|
|
55
55
|
|
|
56
|
-
| Source
|
|
57
|
-
|
|
|
58
|
-
| **pi**
|
|
59
|
-
| **codex**
|
|
60
|
-
| **
|
|
56
|
+
| Source | Pattern | Discovery |
|
|
57
|
+
| -------------- | --------------------------------- | -------------------------------- |
|
|
58
|
+
| **pi** | `~/.pi/agent/sessions/**/*.jsonl` | Automatic |
|
|
59
|
+
| **codex** | `~/.codex/sessions/**/*.jsonl` | Automatic |
|
|
60
|
+
| **Gemini CLI** | `~/.gemini/tmp/*/chats/*.json` | Automatic |
|
|
61
|
+
| **OpenCode** | `~/.opencode/opencode.db` | Auto or explicit `--opencode-db` |
|
|
61
62
|
|
|
62
63
|
OpenCode source support requires Node.js 24+ runtime with built-in `node:sqlite`.
|
|
63
64
|
|
|
@@ -123,16 +124,17 @@ For source-by-source comparisons, run the same report per source:
|
|
|
123
124
|
```bash
|
|
124
125
|
llm-usage efficiency monthly --repo-dir /path/to/repo --source pi
|
|
125
126
|
llm-usage efficiency monthly --repo-dir /path/to/repo --source codex
|
|
127
|
+
llm-usage efficiency monthly --repo-dir /path/to/repo --source gemini
|
|
126
128
|
llm-usage efficiency monthly --repo-dir /path/to/repo --source opencode
|
|
127
129
|
```
|
|
128
130
|
|
|
129
|
-
Note: usage filters (`--source`, `--provider`, `--model`, `--pi-dir`, `--codex-dir`, `--opencode-db`, `--source-dir`) also constrain commit attribution: only commit days with matching repo-attributed usage events are counted.
|
|
131
|
+
Note: usage filters (`--source`, `--provider`, `--model`, `--pi-dir`, `--codex-dir`, `--gemini-dir`, `--opencode-db`, `--source-dir`) also constrain commit attribution: only commit days with matching repo-attributed usage events are counted.
|
|
130
132
|
|
|
131
133
|
### Filtering
|
|
132
134
|
|
|
133
135
|
```bash
|
|
134
136
|
# By source
|
|
135
|
-
llm-usage monthly --source pi,codex
|
|
137
|
+
llm-usage monthly --source pi,codex,gemini
|
|
136
138
|
|
|
137
139
|
# By provider
|
|
138
140
|
llm-usage monthly --provider openai
|
|
@@ -148,9 +150,10 @@ llm-usage monthly --source opencode --provider openai --model gpt-4.1
|
|
|
148
150
|
|
|
149
151
|
```bash
|
|
150
152
|
# Custom directories
|
|
151
|
-
llm-usage daily --source-dir pi=/path/to/pi --source-dir codex=/path/to/codex
|
|
153
|
+
llm-usage daily --source-dir pi=/path/to/pi --source-dir codex=/path/to/codex --source-dir gemini=/path/to/.gemini
|
|
152
154
|
|
|
153
|
-
# Explicit OpenCode
|
|
155
|
+
# Explicit Gemini/OpenCode paths
|
|
156
|
+
llm-usage daily --gemini-dir /path/to/.gemini
|
|
154
157
|
llm-usage daily --opencode-db /path/to/opencode.db
|
|
155
158
|
```
|
|
156
159
|
|