tokelytics 0.2.0 → 0.3.1

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 +12 -3
  2. package/bin/tokelytics.mjs +1446 -446
  3. package/package.json +18 -6
package/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Tokelytics agent
2
2
 
3
- Reads local AI-CLI usage logs and streams them to your Tokelytics dashboard in
4
- realtime. v1 connectors: **Claude Code** (`~/.claude/projects`) and **Codex**
3
+ Reads local AI-CLI usage logs immediately and publishes quota-budgeted dashboard
4
+ snapshots. v1 connectors: **Claude Code** (`~/.claude/projects`) and **Codex**
5
5
  (`~/.codex/sessions`). Only token counts/model/timestamps are read — never your
6
6
  prompts or responses.
7
7
 
@@ -9,9 +9,12 @@ prompts or responses.
9
9
 
10
10
  ```
11
11
  npx tokelytics@latest login # opens your browser to approve — no setup, no keys
12
- npx tokelytics@latest watch # streams usage in realtime
12
+ npx tokelytics@latest watch # watches locally; cloud snapshot up to every 30m
13
13
  ```
14
14
 
15
+ Keep `@latest` in install and onboarding commands. Agents older than 0.3.1
16
+ cannot write to the hardened Firestore schema.
17
+
15
18
  Other commands: `sync` (one pass), `status`, `logout`.
16
19
 
17
20
  ### How login works (and why there's no API key)
@@ -32,6 +35,12 @@ it. On a headless/SSH box, open the printed link in any browser on a machine
32
35
  where you can sign in (it must be able to reach `127.0.0.1:<port>` on the box, so
33
36
  forward the port or run `login` where a browser is available).
34
37
 
38
+ When you click **Approve & connect**, Chrome may ask whether
39
+ `tokelytics.web.app` can access devices on your local network. Choose **Allow**:
40
+ this lets the page reach the temporary Tokelytics listener on `127.0.0.1`. If
41
+ the prompt was blocked, open the site controls beside the address bar, choose
42
+ **Site settings**, set **Local network access** to **Allow**, then retry.
43
+
35
44
  ## Configuration (optional)
36
45
 
37
46
  Nothing is required — the agent targets the hosted `tokelytics` project by