npm - tokentracker-cli - Versions diffs - 0.2.24 → 0.2.26 - Mend

tokentracker-cli 0.2.24 → 0.2.26

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 (23) hide show

package/dashboard/dist/index.html CHANGED Viewed

@@ -107,7 +107,7 @@
         ]
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-BYPG1_bI.js"></script>
+    <script type="module" crossorigin src="/assets/main-B206gspN.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/main-hwTpulbk.css">
   </head>
   <body>

package/dashboard/dist/share.html CHANGED Viewed

@@ -51,7 +51,7 @@
         "description": "Shareable Token Tracker dashboard snapshot."
       }
     </script>
-    <script type="module" crossorigin src="/assets/main-BYPG1_bI.js"></script>
+    <script type="module" crossorigin src="/assets/main-B206gspN.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/main-hwTpulbk.css">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "tokentracker-cli",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "description": "Token usage tracker for AI agent CLIs (Codex, Claude Code, Gemini, OpenCode, OpenClaw)",
   "main": "src/cli.js",
   "bin": {

package/src/commands/init.js CHANGED Viewed

@@ -166,7 +166,7 @@ async function cmdInit(argv) {
   let deviceId = setup.deviceId;
   // Cloud account linking — only when explicitly requested via env or flags
-  const wantCloudLink = setup.pendingBrowserAuth && (opts.linkCode || process.env.VIBEUSAGE_DEVICE_TOKEN || process.env.VIBEUSAGE_ACCESS_TOKEN);
+  const wantCloudLink = setup.pendingBrowserAuth && (opts.linkCode || process.env.TOKENTRACKER_DEVICE_TOKEN || process.env.TOKENTRACKER_ACCESS_TOKEN);
   if (wantCloudLink) {
     const deviceName = opts.deviceName || os.hostname();
@@ -758,8 +758,8 @@ const fallbackPkg = ${JSON.stringify(fallbackPkg)};
 const selfPath = path.resolve(__filename);
 const home = os.homedir();
 const debugLogPath = path.join(trackerDir, 'notify.debug.jsonl');
-const debugEnabled = ['1', 'true'].includes((process.env.VIBEUSAGE_NOTIFY_DEBUG || '').toLowerCase());
-const debugMaxBytesRaw = Number.parseInt(process.env.VIBEUSAGE_NOTIFY_DEBUG_MAX_BYTES || '', 10);
+const debugEnabled = ['1', 'true'].includes((process.env.TOKENTRACKER_NOTIFY_DEBUG || '').toLowerCase());
+const debugMaxBytesRaw = Number.parseInt(process.env.TOKENTRACKER_NOTIFY_DEBUG_MAX_BYTES || '', 10);
 const debugMaxBytes = Number.isFinite(debugMaxBytesRaw) && debugMaxBytesRaw > 0
   ? debugMaxBytesRaw
   : 1_000_000;
@@ -791,7 +791,7 @@ if (debugEnabled) {
 // Throttle spawn: at most once per 20 seconds.
 try {
     const throttlePath = path.join(trackerDir, 'sync.throttle');
-    let deviceToken = process.env.VIBEUSAGE_DEVICE_TOKEN || null;
+    let deviceToken = process.env.TOKENTRACKER_DEVICE_TOKEN || null;
     if (!deviceToken) {
       try {
         const cfg = JSON.parse(fs.readFileSync(configPath, 'utf8'));
@@ -967,5 +967,5 @@ async function copyRuntimeDependencies({ from, to }) {
 }
 function isDebugEnabled() {
-  return process.env.VIBEUSAGE_DEBUG === "1";
+  return process.env.TOKENTRACKER_DEBUG === "1";
 }

package/src/commands/sync.js CHANGED Viewed

@@ -486,26 +486,26 @@ function normalizeString(value) {
 function resolveOpenclawSignal({ home, env } = {}) {
   if (!env) return null;
-  const agentId = normalizeString(env.VIBEUSAGE_OPENCLAW_AGENT_ID);
-  const sessionId = normalizeString(env.VIBEUSAGE_OPENCLAW_PREV_SESSION_ID);
+  const agentId = normalizeString(env.TOKENTRACKER_OPENCLAW_AGENT_ID);
+  const sessionId = normalizeString(env.TOKENTRACKER_OPENCLAW_PREV_SESSION_ID);
   if (!agentId || !sessionId) return null;
   const openclawHome =
-    normalizeString(env.VIBEUSAGE_OPENCLAW_HOME) || path.join(home || os.homedir(), ".openclaw");
+    normalizeString(env.TOKENTRACKER_OPENCLAW_HOME) || path.join(home || os.homedir(), ".openclaw");
   const sessionFile = path.join(openclawHome, "agents", agentId, "sessions", `${sessionId}.jsonl`);
   const prevTotals = {
-    totalTokens: normalizeNonNegativeInt(env.VIBEUSAGE_OPENCLAW_PREV_TOTAL_TOKENS),
-    inputTokens: normalizeNonNegativeInt(env.VIBEUSAGE_OPENCLAW_PREV_INPUT_TOKENS),
-    outputTokens: normalizeNonNegativeInt(env.VIBEUSAGE_OPENCLAW_PREV_OUTPUT_TOKENS),
-    model: normalizeString(env.VIBEUSAGE_OPENCLAW_PREV_MODEL),
-    updatedAt: normalizeIsoOrEpoch(env.VIBEUSAGE_OPENCLAW_PREV_UPDATED_AT),
+    totalTokens: normalizeNonNegativeInt(env.TOKENTRACKER_OPENCLAW_PREV_TOTAL_TOKENS),
+    inputTokens: normalizeNonNegativeInt(env.TOKENTRACKER_OPENCLAW_PREV_INPUT_TOKENS),
+    outputTokens: normalizeNonNegativeInt(env.TOKENTRACKER_OPENCLAW_PREV_OUTPUT_TOKENS),
+    model: normalizeString(env.TOKENTRACKER_OPENCLAW_PREV_MODEL),
+    updatedAt: normalizeIsoOrEpoch(env.TOKENTRACKER_OPENCLAW_PREV_UPDATED_AT),
   };
   return {
     agentId,
     sessionId,
-    sessionKey: normalizeString(env.VIBEUSAGE_OPENCLAW_SESSION_KEY),
+    sessionKey: normalizeString(env.TOKENTRACKER_OPENCLAW_SESSION_KEY),
     openclawHome,
     sessionFile,
     prevTotals,

package/src/lib/debug-flags.js CHANGED Viewed

@@ -1,6 +1,6 @@
 function stripDebugFlag(argv, env = process.env) {
   const filtered = Array.isArray(argv) ? argv.filter((arg) => arg !== "--debug") : [];
-  const debugEnv = String(env?.VIBEUSAGE_DEBUG || "") === "1";
+  const debugEnv = String(env?.TOKENTRACKER_DEBUG || "") === "1";
   return { argv: filtered, debug: filtered.length !== (argv || []).length || debugEnv };
 }

package/src/lib/insforge-client.js CHANGED Viewed

@@ -11,11 +11,11 @@ function loadInsforgeSdk() {
 }
 function getAnonKey({ env = process.env } = {}) {
-  return env.VIBEUSAGE_INSFORGE_ANON_KEY || "";
+  return env.TOKENTRACKER_INSFORGE_ANON_KEY || "";
 }
 function getHttpTimeoutMs({ env = process.env } = {}) {
-  const raw = readEnvValue(env, ["VIBEUSAGE_HTTP_TIMEOUT_MS"]);
+  const raw = readEnvValue(env, ["TOKENTRACKER_HTTP_TIMEOUT_MS"]);
   if (raw == null || raw === "") return 20_000;
   const n = Number(raw);
   if (!Number.isFinite(n)) return 20_000;

package/src/lib/openclaw-hook.js CHANGED Viewed

@@ -14,7 +14,7 @@ function resolveOpenclawHookPaths({ home = os.homedir(), trackerDir, env = proce
     normalizeString(env.OPENCLAW_CONFIG_PATH) || path.join(home, ".openclaw", "openclaw.json");
   const openclawHome =
-    normalizeString(env.VIBEUSAGE_OPENCLAW_HOME) ||
+    normalizeString(env.TOKENTRACKER_OPENCLAW_HOME) ||
     normalizeString(env.OPENCLAW_STATE_DIR) ||
     path.join(home, ".openclaw");
@@ -324,21 +324,21 @@ function buildHookHandler({ trackerDir, packageName = "vibeusage", openclawHome
     `\n` +
     `    const env = {\n` +
     `      ...process.env,\n` +
-    `      VIBEUSAGE_OPENCLAW_AGENT_ID: agentId,\n` +
-    `      VIBEUSAGE_OPENCLAW_SESSION_KEY: sessionKey,\n` +
-    `      VIBEUSAGE_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
-    `      VIBEUSAGE_OPENCLAW_HOME: openclawHome\n` +
+    `      TOKENTRACKER_OPENCLAW_AGENT_ID: agentId,\n` +
+    `      TOKENTRACKER_OPENCLAW_SESSION_KEY: sessionKey,\n` +
+    `      TOKENTRACKER_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
+    `      TOKENTRACKER_OPENCLAW_HOME: openclawHome\n` +
     `    };\n` +
     `    const prevTotalTokens = toNonNegativeInt(sessionEntry && sessionEntry.totalTokens);\n` +
     `    const prevInputTokens = toNonNegativeInt(sessionEntry && sessionEntry.inputTokens);\n` +
     `    const prevOutputTokens = toNonNegativeInt(sessionEntry && sessionEntry.outputTokens);\n` +
     `    const prevModel = normalize(sessionEntry && sessionEntry.model);\n` +
     `    const prevUpdatedAt = toIso(sessionEntry && sessionEntry.updatedAt);\n` +
-    `    if (prevTotalTokens != null) env.VIBEUSAGE_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
-    `    if (prevInputTokens != null) env.VIBEUSAGE_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
-    `    if (prevOutputTokens != null) env.VIBEUSAGE_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
-    `    if (prevModel) env.VIBEUSAGE_OPENCLAW_PREV_MODEL = prevModel;\n` +
-    `    if (prevUpdatedAt) env.VIBEUSAGE_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
+    `    if (prevTotalTokens != null) env.TOKENTRACKER_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
+    `    if (prevInputTokens != null) env.TOKENTRACKER_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
+    `    if (prevOutputTokens != null) env.TOKENTRACKER_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
+    `    if (prevModel) env.TOKENTRACKER_OPENCLAW_PREV_MODEL = prevModel;\n` +
+    `    if (prevUpdatedAt) env.TOKENTRACKER_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
     `\n` +
     `    const hasLocalRuntime = fs.existsSync(trackerBinPath);\n` +
     `    const hasLocalDeps = fs.existsSync(depsMarkerPath);\n` +

package/src/lib/openclaw-session-plugin.js CHANGED Viewed

@@ -18,7 +18,7 @@ function resolveOpenclawSessionPluginPaths({
     normalizeString(env.OPENCLAW_CONFIG_PATH) || path.join(home, ".openclaw", "openclaw.json");
   const openclawHome =
-    normalizeString(env.VIBEUSAGE_OPENCLAW_HOME) ||
+    normalizeString(env.TOKENTRACKER_OPENCLAW_HOME) ||
     normalizeString(env.OPENCLAW_STATE_DIR) ||
     path.join(home, ".openclaw");
@@ -414,22 +414,22 @@ function buildSessionPluginIndex({ trackerDir, packageName = "vibeusage", opencl
     `\n` +
     `function buildSessionEnv({ agentId, sessionId, sessionKey, sessionEntry }) {\n` +
     `  const out = {\n` +
-    `    VIBEUSAGE_OPENCLAW_AGENT_ID: agentId,\n` +
-    `    VIBEUSAGE_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
-    `    VIBEUSAGE_OPENCLAW_HOME: openclawHome\n` +
+    `    TOKENTRACKER_OPENCLAW_AGENT_ID: agentId,\n` +
+    `    TOKENTRACKER_OPENCLAW_PREV_SESSION_ID: sessionId,\n` +
+    `    TOKENTRACKER_OPENCLAW_HOME: openclawHome\n` +
     `  };\n` +
     `  const key = normalize(sessionKey);\n` +
-    `  if (key) out.VIBEUSAGE_OPENCLAW_SESSION_KEY = key;\n` +
+    `  if (key) out.TOKENTRACKER_OPENCLAW_SESSION_KEY = key;\n` +
     `  const prevTotalTokens = toNonNegativeInt(sessionEntry && sessionEntry.totalTokens);\n` +
     `  const prevInputTokens = toNonNegativeInt(sessionEntry && sessionEntry.inputTokens);\n` +
     `  const prevOutputTokens = toNonNegativeInt(sessionEntry && sessionEntry.outputTokens);\n` +
     `  const prevModel = normalize(sessionEntry && sessionEntry.model);\n` +
     `  const prevUpdatedAt = toIso(sessionEntry && sessionEntry.updatedAt);\n` +
-    `  if (prevTotalTokens != null) out.VIBEUSAGE_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
-    `  if (prevInputTokens != null) out.VIBEUSAGE_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
-    `  if (prevOutputTokens != null) out.VIBEUSAGE_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
-    `  if (prevModel) out.VIBEUSAGE_OPENCLAW_PREV_MODEL = prevModel;\n` +
-    `  if (prevUpdatedAt) out.VIBEUSAGE_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
+    `  if (prevTotalTokens != null) out.TOKENTRACKER_OPENCLAW_PREV_TOTAL_TOKENS = String(prevTotalTokens);\n` +
+    `  if (prevInputTokens != null) out.TOKENTRACKER_OPENCLAW_PREV_INPUT_TOKENS = String(prevInputTokens);\n` +
+    `  if (prevOutputTokens != null) out.TOKENTRACKER_OPENCLAW_PREV_OUTPUT_TOKENS = String(prevOutputTokens);\n` +
+    `  if (prevModel) out.TOKENTRACKER_OPENCLAW_PREV_MODEL = prevModel;\n` +
+    `  if (prevUpdatedAt) out.TOKENTRACKER_OPENCLAW_PREV_UPDATED_AT = prevUpdatedAt;\n` +
     `  return out;\n` +
     `}\n` +
     `\n` +

package/src/lib/opencode-config.js CHANGED Viewed

@@ -5,7 +5,7 @@ const fs = require("node:fs/promises");
 const { ensureDir } = require("./fs");
 const DEFAULT_PLUGIN_NAME = "vibeusage-tracker.js";
-const PLUGIN_MARKER = "VIBEUSAGE_TRACKER_PLUGIN";
+const PLUGIN_MARKER = "TOKENTRACKER_PLUGIN";
 const DEFAULT_EVENT = "session.updated";
 function resolveOpencodeConfigDir({ home = os.homedir(), env = process.env } = {}) {

package/src/lib/runtime-config.js CHANGED Viewed

@@ -6,36 +6,36 @@ function resolveRuntimeConfig({ cli = {}, config = {}, env = process.env, defaul
   const baseUrl = pickString(
     cli.baseUrl,
     config.baseUrl,
-    env?.VIBEUSAGE_INSFORGE_BASE_URL,
+    env?.TOKENTRACKER_INSFORGE_BASE_URL,
     defaults.baseUrl,
     DEFAULT_BASE_URL,
   );
   const dashboardUrl = pickString(
     cli.dashboardUrl,
     config.dashboardUrl,
-    env?.VIBEUSAGE_DASHBOARD_URL,
+    env?.TOKENTRACKER_DASHBOARD_URL,
     defaults.dashboardUrl,
     DEFAULT_DASHBOARD_URL,
   );
   const deviceToken = pickString(
     cli.deviceToken,
     config.deviceToken,
-    env?.VIBEUSAGE_DEVICE_TOKEN,
+    env?.TOKENTRACKER_DEVICE_TOKEN,
     defaults.deviceToken,
     null,
   );
   const httpTimeoutMs = pickHttpTimeoutMs(
     cli.httpTimeoutMs,
     config.httpTimeoutMs,
-    env?.VIBEUSAGE_HTTP_TIMEOUT_MS,
+    env?.TOKENTRACKER_HTTP_TIMEOUT_MS,
     defaults.httpTimeoutMs,
     DEFAULT_HTTP_TIMEOUT_MS,
   );
-  const debug = pickBoolean(cli.debug, config.debug, env?.VIBEUSAGE_DEBUG, defaults.debug, false);
+  const debug = pickBoolean(cli.debug, config.debug, env?.TOKENTRACKER_DEBUG, defaults.debug, false);
   const insforgeAnonKey = pickString(
     cli.insforgeAnonKey,
     config.insforgeAnonKey,
-    env?.VIBEUSAGE_INSFORGE_ANON_KEY,
+    env?.TOKENTRACKER_INSFORGE_ANON_KEY,
     defaults.insforgeAnonKey,
     "",
   );
@@ -43,7 +43,7 @@ function resolveRuntimeConfig({ cli = {}, config = {}, env = process.env, defaul
   const autoRetryNoSpawn = pickBoolean(
     cli.autoRetryNoSpawn,
     config.autoRetryNoSpawn,
-    env?.VIBEUSAGE_AUTO_RETRY_NO_SPAWN,
+    env?.TOKENTRACKER_AUTO_RETRY_NO_SPAWN,
     defaults.autoRetryNoSpawn,
     false,
   );

package/README.old.md DELETED Viewed

@@ -1,324 +0,0 @@
-<div align="center">
-<img src="dashboard/public/icon-192.png" width="96" alt="VibeUsage Icon" />
-# 🟢 VIBEUSAGE
-**QUANTIFY YOUR AI OUTPUT**
-_Real-time AI Analytics for Codex CLI_
-[**www.vibeusage.cc**](https://www.vibeusage.cc)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
-[![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
-[**English**](README.md) • [**中文说明**](README.zh-CN.md)
-[**Documentation**](docs/) • [**Dashboard**](dashboard/) • [**Backend API**](BACKEND_API.md)
-<br/>
-<img src="docs/screenshots/dashboard.png" width="900" alt="VibeUsage Dashboard Preview"/>
-</div>
----
-## 🌌 Overview
-**VibeUsage** is an intelligent token usage tracking system designed specifically for macOS developers. Through the all-new **Matrix-A Design System**, it provides a high-fidelity cyberpunk-style dashboard that transforms your **AI Output** into quantifiable metrics, supported by the **Neural Divergence Map** for real-time monitoring of multi-model compute distribution.
-> [!TIP] > **Core Index**: Our signature metric that reflects your flow state by analyzing token consumption rates and patterns.
-## 🔒 Privacy-First Architecture (Stealth Protocol)
-We believe your code and thoughts are your own. VibeUsage is built with strict privacy pillars to ensure your data never leaves your control.
-- 🛡️ **No Content Upload**: We never upload prompts or responses. We only compute token counts locally and send counts plus minimal metadata (timestamps, model, device).
-- 📡 **Local Aggregation**: All token consumption analysis happens on your machine. We only relay quantized 30-minute usage buckets to the cloud.
-- 🔐 **Hashed Identity**: Device tokens are hashed using SHA-256 server-side. Your raw credentials never exist in our database.
-- 🔦 **Full Transparency**: Audit the sync logic yourself in `src/lib/rollout.js`. We literally only capture numbers and timestamps.
-## 🚀 Key Features
-- 📡 **Auto-Sync**: Real-time interception of AI CLI pipes with **automatic background synchronization**. Once initialized, your tokens are tracked and synced without any manual commands.
-- 🧭 **Universal-Sync**: Native support for multiple AI CLI tools:
-  - **Codex CLI** - OpenAI's official CLI
-  - **Every Code** - Community Codex alternative
-  - **Gemini CLI** - Google's AI CLI
-  - **Opencode** - AI coding assistant
-  - **Claude Code** - Anthropic's official CLI
-  - Whether it's GPT-4, Claude 3.5 Sonnet, or o1/Gemini, token consumption from all models is unified and counted.
-- 📊 **Matrix Dashboard**: High-performance dashboard built with React + Vite, featuring the new **Matrix-A** design language.
-  - **Neural Divergence Map**: Visualize multi-engine load balancing and compute distribution.
-  - **Cost Intelligence**: Real-time, multi-dimensional cost breakdown and forecasting.
-  - **Activity Heatmap**: GitHub-style contribution graph with streak tracking.
-  - **Smart Notifications**: Non-intrusive system-level alerts using a Golden (Gold/Amber) visual style for high-value information.
-- ⚡ **AI Analytics**: Deep analysis of Input/Output tokens, with dedicated tracking for Cached and Reasoning components.
-- 📈 **Leaderboard**: Daily, weekly, monthly, and all-time rankings with privacy-safe display names.
-- 🌐 **Public View**: Share your AI usage journey with a privacy-safe public profile.
-- 📁 **Project Stats**: Track token usage by project/repository across all time.
-- 🔒 **Identity Core**: Robust authentication and permission management to secure your development data.
-### 🌌 Visual Preview
-<img src="docs/screenshots/landing.png" width="900" alt="VibeUsage Landing Preview"/>
-## 🛠️ Quick Start
-### Installation
-Initialize your environment once and forget it. VibeUsage handles all synchronization in the background automatically.
-```bash
-npx --yes vibeusage init
-```
-**Authentication Methods:**
-1. **Browser Auth** (default) - Opens browser for secure authentication
-2. **Link Code** - Use `--link-code` to authenticate via dashboard-generated code
-3. **Password** - Direct password authentication (fallback)
-4. **Access Token** - For CI/automated environments
-**CLI Options:**
-- `--yes` - Skip consent prompts in non-interactive environments
-- `--dry-run` - Preview changes without writing files
-- `--link-code <code>` - Authenticate using a link code from dashboard
-- `--base-url <url>` - Override the default API endpoint
-**Supported CLI Tools Auto-Configuration:**
-| Tool | Config Location | Method |
-|------|----------------|--------|
-| Codex CLI | `~/.codex/config.toml` | `notify` hook |
-| Every Code | `~/.code/config.toml` (or `CODE_HOME`) | `notify` hook |
-| Gemini CLI | `~/.gemini/settings.json` (or `GEMINI_HOME`) | `SessionEnd` hook |
-| Opencode | Global plugins | Message parser plugin |
-| Claude Code | `~/.claude/hooks/` | Hook configuration |
-Once `init` completes, all supported CLI tools are automatically configured for data sync. No further intervention required.
-### Sync & Status
-While sync happens automatically, you can manually trigger a synchronization or check status anytime:
-```bash
-# Manually sync latest local session data (Optional)
-npx --yes vibeusage sync
-# Check current link status
-npx --yes vibeusage status
-```
-### Doctor
-```bash
-# Run health checks
-npx --yes vibeusage doctor
-# Emit JSON report (and write to file)
-npx --yes vibeusage doctor --json --out doctor.json
-# Override base URL (diagnostics only)
-npx --yes vibeusage doctor --base-url https://example.invalid
-```
-### Uninstall
-```bash
-# Standard uninstall (keeps data)
-npx --yes vibeusage uninstall
-# Full purge - removes all data including config and cached sessions
-npx --yes vibeusage uninstall --purge
-```
-### Log Sources
-| Tool | Log Location | Override Env |
-|------|-------------|--------------|
-| Codex CLI | `~/.codex/sessions/**/rollout-*.jsonl` | `CODEX_HOME` |
-| Every Code | `~/.code/sessions/**/rollout-*.jsonl` | `CODE_HOME` |
-| Gemini CLI | `~/.gemini/tmp/**/chats/session-*.json` | `GEMINI_HOME` |
-| Opencode | `~/.opencode/messages/*.json` | - |
-| Claude Code | Parsed from hook output | - |
-## 🔧 Environment Variables
-### Core Settings
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `VIBEUSAGE_HTTP_TIMEOUT_MS` | CLI HTTP timeout in ms (`0` disables, clamped `1000..120000`) | `20000` |
-| `VITE_VIBEUSAGE_HTTP_TIMEOUT_MS` | Dashboard request timeout in ms (`0` disables, clamped `1000..30000`) | `15000` |
-| `VIBEUSAGE_DEBUG` | Enable debug output (`1` or `true` to enable) | - |
-| `VIBEUSAGE_DASHBOARD_URL` | Custom dashboard URL | `https://www.vibeusage.cc` |
-| `VIBEUSAGE_INSFORGE_BASE_URL` | Custom API base URL | `https://5tmappuk.us-east.insforge.app` |
-| `VIBEUSAGE_DEVICE_TOKEN` | Pre-configured device token (for CI) | - |
-### CLI Tool Overrides
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `CODEX_HOME` | Codex CLI directory override | `~/.codex` |
-| `CODE_HOME` | Every Code directory override | `~/.code` |
-| `GEMINI_HOME` | Gemini CLI directory override | `~/.gemini` |
-### Deprecated
-- `VIBEUSAGE_ROLLUP_ENABLED`: Currently ignored; rollup aggregation is disabled pending table deployment.
-## 🧰 Troubleshooting
-### Debug Mode
-Enable debug output to see detailed request/response information:
-```bash
-VIBEUSAGE_DEBUG=1 npx --yes vibeusage sync
-# or
-npx --yes vibeusage sync --debug
-```
-### Health Check
-Run the built-in doctor command to diagnose issues:
-```bash
-# Basic health check
-npx --yes vibeusage doctor
-# JSON output for debugging
-npx --yes vibeusage doctor --json --out doctor.json
-# Test against a different endpoint
-npx --yes vibeusage doctor --base-url https://your-instance.insforge.app
-```
-### Streak shows 0 days while totals look correct
-- Streak is defined as consecutive days ending today. If today's total is 0, streak will be 0.
-- If you expect a non-zero streak, clear cached auth/heatmap data and sign in again:
-```js
-localStorage.removeItem("vibeusage.dashboard.auth.v1");
-Object.keys(localStorage)
-  .filter((k) => k.startsWith("vibeusage.heatmap."))
-  .forEach((k) => localStorage.removeItem(k));
-location.reload();
-```
-- Complete the landing page sign-in flow again after reload.
-- Note: `insforge-auth-token` is not used by the dashboard; use `vibeusage.dashboard.auth.v1`.
-### Sync Issues
-If data isn't appearing in the dashboard:
-1. Check status: `npx --yes vibeusage status`
-2. Force manual sync: `npx --yes vibeusage sync`
-3. Verify CLI tool hooks are configured (re-run `init` if needed)
-4. Check debug output: `VIBEUSAGE_DEBUG=1 npx vibeusage sync`
-### Timeout Errors
-Increase HTTP timeout for slow connections:
-```bash
-VIBEUSAGE_HTTP_TIMEOUT_MS=60000 npx --yes vibeusage sync
-```
-## 🏗️ Architecture
-```mermaid
-graph TD
-    A[Codex CLI] -->|Rollout Logs| F(Tracker CLI)
-    B[Every Code] -->|Rollout Logs| F
-    C[Gemini CLI] -->|Session Logs| F
-    D[Opencode] -->|Message Logs| F
-    E[Claude Code] -->|Hook Output| F
-    F -->|AI Tokens| G{Core Relay}
-    G --> H[VibeUsage Dashboard]
-    G --> I[AI Analytics Engine]
-    G --> J[Leaderboard Service]
-    G --> K[Public View API]
-```
-### Components
-- **Tracker CLI** (`src/`): Node.js CLI that parses logs from multiple AI tools and syncs token data
-- **Core Relay** (InsForge Edge Functions): Serverless backend handling ingestion, aggregation, and API
-- **Dashboard** (`dashboard/`): React + Vite frontend for visualization
-- **AI Analytics Engine**: Cost calculation, model breakdown, and usage forecasting
-## 💻 Developer Guide
-To run locally or contribute:
-### Dashboard Development
-```bash
-# Install dependencies
-cd dashboard
-npm install
-# Start dev server
-npm run dev
-```
-### Debug Payload (Usage Endpoints)
-When `debug=1` is included in a usage endpoint request, the response adds a `debug` object that helps the dashboard attribute slow queries without relying on response headers.
-```ts
-const res = await fetch(
-  `${baseUrl}/functions/vibeusage-usage-summary?from=2025-12-30&to=2025-12-30&debug=1`,
-  {
-    headers: { Authorization: `Bearer ${userJwt}` }
-  }
-);
-const data = await res.json();
-if (data.debug) {
-  console.debug('usage debug', {
-    requestId: data.debug.request_id,
-    status: data.debug.status,
-    queryMs: data.debug.query_ms,
-    slowThresholdMs: data.debug.slow_threshold_ms,
-    slowQuery: data.debug.slow_query
-  });
-}
-```
-### Architecture Validation
-```bash
-# Validate Copy Registry
-npm run validate:copy
-# Run smoke tests
-npm run smoke
-```
-### Architecture Canvas Focus
-```bash
-# Generate a focused canvas for a top-level module
-node scripts/ops/architecture-canvas.cjs --focus src
-# Alias: --module
-node scripts/ops/architecture-canvas.cjs --module dashboard
-```
-## 📜 License
-This project is licensed under the [MIT License](LICENSE).
----
-<div align="center">
-  <b>System_Ready // 2024 VibeUsage OS</b><br/>
-  <i>"More Tokens. More Vibe."</i>
-</div>