@tokenboard/cli 0.0.1 → 0.1.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.
package/README.md CHANGED
@@ -2,12 +2,29 @@
2
2
 
3
3
  A leaderboard for your agentic-coding token usage — race your friends, not strangers.
4
4
 
5
- > **Status:** placeholder release. The real CLI is in active development. This
6
- > package name is reserved while the tool is built. Follow along at
5
+ > **Status:** early release — local preview only. Sign-in, public boards, and
6
+ > syncing land in upcoming releases. Follow along at
7
7
  > [tokenboard.sh](https://tokenboard.sh).
8
8
 
9
9
  ```bash
10
- npx @tokenboard/cli
10
+ npx @tokenboard/cli # local preview: your token usage + a rough $ estimate
11
+ npx @tokenboard/cli show-data # dry-run: exactly what a future sync would upload
11
12
  ```
12
13
 
13
- MIT licensed.
14
+ ## What it does today
15
+
16
+ - Parses your local **Claude Code** session logs (`~/.claude/projects`) and shells
17
+ out to [`ccusage`](https://github.com/ryoppippi/ccusage) for the long tail (Codex,
18
+ Gemini, Goose, …) — **counts only**, never prompts, code, or file paths.
19
+ - Prints your total tokens and a **labeled `~$` estimate** computed offline from a
20
+ bundled [LiteLLM](https://github.com/BerriAI/litellm) price snapshot. The estimate
21
+ is cosmetic — the server is authoritative once syncing exists.
22
+
23
+ ## Privacy
24
+
25
+ Runs **fully offline** — nothing is uploaded and no account is created. The only
26
+ outbound traffic is `npx` fetching the pinned `ccusage` package (an npm install, not
27
+ your usage data); with no network it's skipped and Claude Code still renders.
28
+
29
+ MIT licensed. Credits [ccusage](https://github.com/ryoppippi/ccusage) and
30
+ [LiteLLM](https://github.com/BerriAI/litellm) — see `NOTICES.md`.