llm-usage-metrics 0.10.1 → 0.10.2

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.
Files changed (3) hide show
  1. package/README.md +7 -2
  2. package/dist/index.js +659 -234
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  <h1 align="center">llm-usage-metrics</h1>
6
6
 
7
7
  <p align="center">
8
- Local usage reports for AI coding tools.
8
+ Usage reports for AI coding tools, across all your machines.
9
9
  </p>
10
10
 
11
11
  <p align="center">
@@ -23,10 +23,12 @@
23
23
  <a href="./CONTRIBUTING.md">Contributing</a>
24
24
  </p>
25
25
 
26
- `llm-usage-metrics` reads local session data from 17 AI coding tools and converts it into one normalized usage history. Use it to review tokens and estimated cost, compare periods, find expensive sessions, correlate usage with local Git activity, or export the result.
26
+ `llm-usage-metrics` reads local session data from 17 AI coding tools, on this machine and on others you reach over ssh, and converts it into one normalized usage history. Use it to review tokens and estimated cost, compare periods, find expensive sessions, correlate usage with local Git activity, or export the result.
27
27
 
28
28
  The CLI parses session content on your machine. It discovers standard source locations and includes a bundled pricing snapshot, so the first report can run without configuration or network access.
29
29
 
30
+ See [Privacy](https://ayagmar.github.io/llm-usage-metrics/privacy/) for what it reads, stores, and sends over the network.
31
+
30
32
  ## Quick start
31
33
 
32
34
  Requires Node.js 22.16+ or 24+ (Node 23 lacks the SQLite busy timeout the ledger uses), or Bun 1.4+.
@@ -193,6 +195,7 @@ Reports can include your other machines' usage over ssh. Install llm-usage-metri
193
195
  llm-usage machine add laptop # syncs over ssh laptop; see the docs for other destinations
194
196
  llm-usage monthly # this machine and the laptop, fetched when due
195
197
  llm-usage monthly --machine laptop # only the laptop
198
+ llm-usage # the summary splits this month's cost by machine
196
199
  ```
197
200
 
198
201
  A session that reached both machines (a copied or synced `~/.claude`) is counted once. See [Multiple machines](https://ayagmar.github.io/llm-usage-metrics/machines/).
@@ -232,6 +235,8 @@ pnpm run build
232
235
 
233
236
  The website has a [docs overview](https://ayagmar.github.io/llm-usage-metrics/docs/) and a [report chooser](https://ayagmar.github.io/llm-usage-metrics/reports/) for finding the right command. Its landing page and source navigation use the CLI source registry; regenerate CLI and security references after behavior changes.
234
237
 
238
+ For LLMs and agents, the docs are also published as [llms.txt](https://ayagmar.github.io/llm-usage-metrics/llms.txt) (plus `llms-full.txt` with every page inlined).
239
+
235
240
  Site commands:
236
241
 
237
242
  ```bash