@ipv9/tokentracker-cli 0.39.37 → 0.39.39

package/README.md

@@ -55,7 +55,7 @@ tokentracker doctor     # health check
 - 🔌 **22 tools out of the box.** Claude Code, Codex, Cursor, Gemini, Copilot, Antigravity, OpenCode, Kiro, Zed, Goose, and more — auto-detected.
 - 💰 **Accurate cost.** 2,200+ models priced from [LiteLLM](https://github.com/BerriAI/litellm) (refreshed daily) with a bundled offline snapshot, so USD totals are right even without a network. Cross-provider records are de-duplicated so your numbers match each provider's own billing.
 - 📈 **Rate-limit tracking.** Live quota windows with reset countdowns for Claude, Codex, Cursor, Gemini, Kimi, Z.AI, Kiro, Copilot, and Antigravity.
-- 🧩 **Optional extras.** A worldwide leaderboard (opt-in) and a Skills tab that syncs 250+ public skills across your tools.
+- 🧩 **Skills tab.** Syncs 250+ public skills across your tools.
 
 ---
 
@@ -105,7 +105,7 @@ AI CLI tools  →  hooks / passive readers  →  local SQLite  →  dashboard
 3. Counts are aggregated into 30-minute UTC buckets in a local SQLite snapshot.
 4. The dashboard reads that snapshot and renders it in your browser's timezone.
 
-The leaderboard is the only feature that ever leaves your machine, and only when you opt in.
+Nothing leaves your machine. There is no account, no upload, and no server to sign in to.
 
 ---
 
@@ -114,7 +114,7 @@ The leaderboard is the only feature that ever leaves your machine, and only when
 | Protection | What it means |
 |---|---|
 | **No content** | Only token counts and timestamps. Never prompts, responses, or files. |
-| **Local by default** | All data stays on your machine. The leaderboard is fully opt-in. |
+| **Local only** | All data stays on your machine. There is no upload path at all. |
 | **Auditable** | Open source — read [`src/lib/rollout.js`](src/lib/rollout.js); it's just numbers and timestamps. |
 | **No telemetry** | No analytics, no crash reporting, no phone-home. |
 
@@ -132,7 +132,16 @@ Most users never touch this — defaults are sensible.
 | `GEMINI_HOME` | Override Gemini CLI directory | `~/.gemini` |
 | `TOKENTRACKER_GROK_HOME` | Override Grok Build directory | `~/.grok` |
 
-To force a dashboard port: `PORT=7700 tokentracker serve` (otherwise it auto-picks the next free port from `7680`).
+To force a dashboard port, use your shell's environment-variable syntax (otherwise TokenTracker auto-picks the next free port from `7680`):
+
+```bash
+PORT=7700 npx --yes @ipv9/tokentracker-cli serve
+```
+
+```powershell
+$env:PORT = 7700
+npx --yes @ipv9/tokentracker-cli serve
+```
 
 Browser auto-open is opt-in: `tokentracker serve --open`. Background services and headless shells should use the default no-open behavior and open the printed URL manually.
 
@@ -153,6 +162,15 @@ npm test          # root tests
 npm run ci:local  # full local gate (build + tests + validators)
 ```
 
+## 📚 Code Documentation
+
+Source-backed engineering documentation starts at
+[`openwiki/README.md`](openwiki/README.md). Regenerate the local fact
+ledger with `npm run docs:openwiki:extract`, validate it with
+`npm run docs:openwiki:check`, and use `npm run docs:openwiki:verify` for the
+independent read-only review. The model-backed update command expects credentials
+from the caller's environment and never reads them from this repository.
+
 ---
 
 ## 🔧 Troubleshooting
@@ -176,7 +194,15 @@ If a tool you use shows as not configured, run `tokentracker activate-if-needed`
 
 <br/>
 
-The server auto-picks the next free port (`7681`, `7682`, …) and logs it on startup. To force one: `PORT=7700 tokentracker serve`. To see what's holding the port: `lsof -i :7680`.
+The server auto-picks the next free port (`7681`, `7682`, …) and logs it on startup. To force one, use the Bash or PowerShell command in [Configuration](#configuration). To see what's holding port `7680`:
+
+```bash
+lsof -i :7680
+```
+
+```powershell
+Get-NetTCPConnection -LocalPort 7680 -ErrorAction SilentlyContinue
+```
 
 </details>
 
@@ -204,17 +230,23 @@ tokentracker doctor
 </details>
 
 <details>
-<summary><b>Windows / PowerShell service starts but no browser opens</b></summary>
+<summary><b>Windows / PowerShell: start TokenTracker with npx</b></summary>
 
 <br/>
 
-This is expected for background tasks. Scheduled tasks and the Windows tray app run:
+For an interactive PowerShell session:
+
+```powershell
+npx --yes @ipv9/tokentracker-cli serve --open
+```
+
+For headless PowerShell, CI, or a background process, keep browser opening disabled:
 
 ```powershell
-tokentracker serve --no-sync --no-open
+npx --yes @ipv9/tokentracker-cli serve --no-sync --no-open
 ```
 
-Open the printed local URL in your browser or use the tray app WebView. For an interactive PowerShell session, use `tokentracker serve --open`; TokenTracker uses the Windows shell opener instead of `xdg-open`.
+TokenTracker never stops another process to free a port. When no port is specified it tries the next one up (`7681`, `7682`, …); an explicit `--port` or `$env:PORT` that is already in use fails startup and prints an alternative command to run.
 
 </details>
 

package/dashboard/dist/assets/{Card-DKmo-v8a.js → Card-BbRYRVXf.js}

@@ -1 +1 @@
-import{j as r}from"./main-CPGI-smk.js";function t({children:i,title:a,subtitle:o,className:s="",bodyClassName:d=""}){return r.jsxs("div",{className:`rounded-xl border border-oai-gray-200 dark:border-oai-gray-800 bg-white dark:bg-oai-gray-900 transition-colors duration-200 ${s}`,children:[(a||o)&&r.jsxs("div",{className:"px-5 py-4 border-b border-oai-gray-200 dark:border-oai-gray-800 transition-colors duration-200",children:[a&&r.jsx("h3",{className:"text-sm font-medium text-oai-gray-500 dark:text-oai-gray-300 uppercase tracking-wide transition-colors duration-200",children:a}),o&&r.jsx("p",{className:"text-sm text-oai-gray-500 dark:text-oai-gray-300 mt-1 transition-colors duration-200",children:o})]}),r.jsx("div",{className:`p-5 ${d}`,children:i})]})}export{t as C};
+import{j as r}from"./main-3gBEI6Jl.js";function t({children:i,title:a,subtitle:o,className:s="",bodyClassName:d=""}){return r.jsxs("div",{className:`rounded-xl border border-oai-gray-200 dark:border-oai-gray-800 bg-white dark:bg-oai-gray-900 transition-colors duration-200 ${s}`,children:[(a||o)&&r.jsxs("div",{className:"px-5 py-4 border-b border-oai-gray-200 dark:border-oai-gray-800 transition-colors duration-200",children:[a&&r.jsx("h3",{className:"text-sm font-medium text-oai-gray-500 dark:text-oai-gray-300 uppercase tracking-wide transition-colors duration-200",children:a}),o&&r.jsx("p",{className:"text-sm text-oai-gray-500 dark:text-oai-gray-300 mt-1 transition-colors duration-200",children:o})]}),r.jsx("div",{className:`p-5 ${d}`,children:i})]})}export{t as C};