whoburnedmore 0.9.5 → 0.9.7

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 +40 -23
  2. package/dist/index.js +3184 -1888
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # whoburnedmore
2
2
 
3
- **who burned more tokens — you or them?** One command reads your local AI coding-agent usage logs, shows your burn, and gives you a **shareable dashboard with no sign-in required**.
3
+ **who burned more tokens — you or them?** One command reads your local AI coding-agent usage logs, adds up your burn, and puts you on the public leaderboard with a **shareable dashboard**.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/whoburnedmore.svg?color=f97316)](https://www.npmjs.com/package/whoburnedmore)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/whoburnedmore.svg?color=f97316)](https://www.npmjs.com/package/whoburnedmore)
@@ -11,7 +11,7 @@
11
11
  npx whoburnedmore
12
12
  ```
13
13
 
14
- That's the whole thing. No install, no account, no config.
14
+ That's the whole thing. No install, no config. Your **first run signs you in** — the CLI opens a page, you approve a short code, and this machine is bound to your account.
15
15
 
16
16
  ---
17
17
 
@@ -28,13 +28,15 @@ whoburnedmore · https://whoburnedmore.com
28
28
  total 2.31B tokens $2,656.91
29
29
  today 92.8M tokens
30
30
 
31
- You burned 2.31B tokens. Your shareable dashboard:
32
- https://whoburnedmore.com/d/5twjwi-jtga4r
31
+ You burned 2.31B tokens. Your dashboard:
32
+ https://whoburnedmore.com/u/<your-handle>
33
33
 
34
- Re-run anytime to update it · `npx whoburnedmore login` to claim a public handle and compete.
34
+ Re-run anytime to update it. Background sync keeps it fresh every 15 min.
35
35
  ```
36
36
 
37
- Your dashboard is **anonymous and unlisted by default** — only people you send the link to can see it. Run the command again anytime to refresh it.
37
+ Once you're signed in, your usage lands on the leaderboard under your handle. Run the command again anytime to refresh — or let the background sync do it for you.
38
+
39
+ **Want to stay off the board?** Run `npx whoburnedmore private` to hide your dashboard, or `npx whoburnedmore --local` to never upload anything at all.
38
40
 
39
41
  ## Privacy first
40
42
 
@@ -46,7 +48,7 @@ See exactly what would be sent, and send nothing:
46
48
  npx whoburnedmore --dry-run
47
49
  ```
48
50
 
49
- Or stay completely offline — `--local` builds the same dashboard as a self-contained HTML file on your machine and opens it in your browser, sending nothing anywhere:
51
+ Or stay completely offline — `--local` builds the same dashboard as a self-contained HTML file on your machine and opens it in your browser, sending nothing anywhere and never signing you in:
50
52
 
51
53
  ```bash
52
54
  npx whoburnedmore --local
@@ -56,14 +58,21 @@ npx whoburnedmore --local
56
58
 
57
59
  | Command | What it does |
58
60
  | --- | --- |
59
- | `npx whoburnedmore` | Show your burn + get a shareable dashboard (no sign-in) |
60
- | `npx whoburnedmore --local` | Build the dashboard locally and open it (fully offline) |
61
+ | `npx whoburnedmore` | Sign in, submit your burn, land on the leaderboard, open your dashboard |
62
+ | `npx whoburnedmore --board=CODE` | Compare with friends — sign in and join their board |
63
+ | `npx whoburnedmore --org=SLUG` | Submit to your organization's board (companies / hackathons) |
64
+ | `npx whoburnedmore --local` | Build the dashboard locally and open it (fully offline, no sign-in) |
61
65
  | `npx whoburnedmore --dry-run` | Print exactly what would be sent, send nothing |
62
66
  | `npx whoburnedmore --no-submit` | Print local stats only, send nothing |
63
- | `npx whoburnedmore login` | Sign in to claim a public handle + join the leaderboard |
64
- | `npx whoburnedmore logout` | Forget the local token (your data is untouched) |
65
- | `npx whoburnedmore install-sync` | Keep your dashboard live with a background sync (every 15 min) |
66
- | `npx whoburnedmore uninstall-sync` | Remove the background sync |
67
+ | `npx whoburnedmore private` | Hide your dashboard from the leaderboard |
68
+ | `npx whoburnedmore public` | Put it back on the leaderboard |
69
+ | `npx whoburnedmore remove` | Delete your dashboard and all its data |
70
+ | `npx whoburnedmore verify` | Delisted? Re-verify your usage to get back on |
71
+ | `npx whoburnedmore link --token=TOKEN` | Bind a server / VM to your account (token from your profile) |
72
+ | `npx whoburnedmore daemon` | Keep syncing in the foreground (containers with no scheduler) |
73
+ | `npx whoburnedmore status` | Check background-sync health (last sync, staleness) |
74
+ | `npx whoburnedmore install-sync` | Turn the 15-minute background sync back on |
75
+ | `npx whoburnedmore uninstall-sync` | Turn the background sync off |
67
76
 
68
77
  ## Supported tools
69
78
 
@@ -73,29 +82,37 @@ Usage is read via [`ccusage`](https://www.npmjs.com/package/ccusage) from any of
73
82
 
74
83
  Whatever you have logs for is picked up automatically — you don't pass any flags.
75
84
 
76
- ## Claim a public handle (optional)
85
+ ## Compete with friends and teams
77
86
 
78
- Want on the public leaderboard? Sign in with **GitHub or Google**:
87
+ - **Friends:** join someone's board with `npx whoburnedmore --board=CODE` (the code comes from their board's invite).
88
+ - **Companies / hackathons:** submit to an organization board with `npx whoburnedmore --org=SLUG` (add `--pass=CODE` if the org requires a join code).
79
89
 
80
- ```bash
81
- npx whoburnedmore login
82
- ```
83
-
84
- It uses a device flow — a code appears in your terminal, you approve it in the browser, and you're done. Your submissions then link to your handle at `whoburnedmore.com/u/<handle>`. You can delete your account and every row of data anytime from your profile.
90
+ Your submissions link to your handle at `whoburnedmore.com/u/<handle>`. You can delete your account and every row of data anytime from your profile.
85
91
 
86
92
  ## Keep it live
87
93
 
88
- Want your dashboard to stay fresh without re-running by hand?
94
+ Background sync is on by default after your first run, so your dashboard stays fresh without re-running by hand. To manage it:
89
95
 
90
96
  ```bash
91
- npx whoburnedmore install-sync # background sync every 15 min (launchd / cron / scheduled task)
92
- npx whoburnedmore uninstall-sync # remove it
97
+ npx whoburnedmore status # last sync + staleness
98
+ npx whoburnedmore uninstall-sync # turn the background sync off
99
+ npx whoburnedmore install-sync # turn it back on (launchd / cron / scheduled task)
93
100
  ```
94
101
 
95
102
  The installed background job runs the latest published `whoburnedmore` package on
96
103
  each sync tick, so future CLI fixes are picked up automatically after the next
97
104
  15-minute refresh.
98
105
 
106
+ ## Servers & VMs
107
+
108
+ Generate a one-time `link` command from your profile on whoburnedmore.com and run it inside the machine to bind it to your account:
109
+
110
+ ```bash
111
+ npx whoburnedmore link --token=TOKEN
112
+ ```
113
+
114
+ On a persistent VM, background sync uses cron or a systemd user timer automatically. In a container or any host without a scheduler, run `npx whoburnedmore daemon` under your process manager instead. Set `WHOBURNEDMORE_CONFIG_DIR` to a persistent path so the machine identity survives restarts.
115
+
99
116
  ## Links
100
117
 
101
118
  - 🏆 Leaderboard — **[whoburnedmore.com](https://whoburnedmore.com)**