token-rats 0.0.2 → 0.0.4

package/README.md

@@ -86,7 +86,3 @@ Authentication uses a device-code flow:
 Token Rats is open source. The CLI source is in [`packages/cli/`](.) and the parsers are in [`packages/parsers/`](../parsers/). You can inspect exactly what is read from your disk and what is sent to the server.
 
 **Privacy posture:** Token Rats reads usage counts only — never prompts or completions. The parser source is in `packages/parsers/`. We literally can't read what you typed.
-
-## License
-
-MIT

package/dist/index.js

@@ -1,5 +1,37 @@
 #!/usr/bin/env node
 
+// src/commands/install-cursor.ts
+import { spawn } from "node:child_process";
+async function installCursorCommand(opts = {}) {
+  const pm = opts.packageManager ?? "npm";
+  console.log("\x1B[1mtoken-rats install-cursor\x1B[0m");
+  console.log(
+    "Installs better-sqlite3 globally for faster Cursor extraction.\nYou don't need this for Cursor support to work \u2014 sql.js (already\nbundled) handles it. This is purely a speed upgrade for large DBs.\n"
+  );
+  const args = ["install", "-g", "better-sqlite3@^9.4.3"];
+  console.log(`\x1B[2m$ ${pm} ${args.join(" ")}\x1B[0m
+`);
+  const exitCode = await new Promise((resolve) => {
+    const child = spawn(pm, args, { stdio: "inherit" });
+    child.on("close", (code) => resolve(code ?? 1));
+    child.on("error", (err) => {
+      console.error(`\x1B[31mFailed to launch ${pm}: ${err.message}\x1B[0m`);
+      resolve(1);
+    });
+  });
+  if (exitCode === 0) {
+    console.log(
+      "\n\x1B[32m\u2713\x1B[0m Done. Future `token-rats sync` runs will prefer better-sqlite3."
+    );
+    return;
+  }
+  console.error(
+    `
+\x1B[31mInstall failed (exit ${exitCode}). Cursor still works via sql.js \u2014 no action required.\x1B[0m`
+  );
+  process.exit(exitCode);
+}
+
 // ../../node_modules/.pnpm/zod@3.23.8/node_modules/zod/lib/index.mjs
 var util;
 (function(util2) {
@@ -4247,7 +4279,11 @@ var ENDPOINTS = {
   stripeWebhook: "/webhooks/stripe",
   // Phase 3 Track M
   proxyAnthropicMessages: "/v1/proxy/anthropic/v1/messages",
-  proxyAnthropicKey: "/v1/proxy/keys/anthropic"
+  proxyAnthropicKey: "/v1/proxy/keys/anthropic",
+  // Admin analytics (project-owner only)
+  adminSignups: "/v1/admin/signups",
+  adminActivity: "/v1/admin/activity",
+  adminReferrers: "/v1/admin/referrers"
 };
 
 // ../contracts/src/errors.ts
@@ -4305,6 +4341,48 @@ var LiveEvent = z.discriminatedUnion("kind", [
   })
 ]);
 
+// ../contracts/src/admin.ts
+var AdminSignupsDay = z.object({
+  day: z.string(),
+  // YYYY-MM-DD UTC
+  /** Newly created users on this day. */
+  newUsers: z.number().int().nonnegative(),
+  /** Running total of users created up to and including this day. */
+  cumulative: z.number().int().nonnegative()
+});
+var AdminSignupsResponse = z.object({
+  totalUsers: z.number().int().nonnegative(),
+  /** Length = 30, ordered oldest -> newest. */
+  series: z.array(AdminSignupsDay),
+  generatedAt: z.number().int().positive()
+});
+var AdminActivityDay = z.object({
+  day: z.string(),
+  // YYYY-MM-DD UTC
+  activeUsers: z.number().int().nonnegative()
+});
+var AdminActivityResponse = z.object({
+  /** Length = 30, ordered oldest -> newest. */
+  series: z.array(AdminActivityDay),
+  /** Distinct users active in the full 30-day window. */
+  activeUsers30d: z.number().int().nonnegative(),
+  generatedAt: z.number().int().positive()
+});
+var AdminReferrerRow = z.object({
+  /** A label describing the source of the signal. */
+  label: z.string(),
+  /** Number of users (or events) attributed to this label. */
+  count: z.number().int().nonnegative()
+});
+var AdminReferrersResponse = z.object({
+  /** True iff a real referral attribution column / table exists. */
+  tracked: z.boolean(),
+  /** Description of what `rows` represents (e.g. "First CLI source"). */
+  signal: z.string(),
+  rows: z.array(AdminReferrerRow),
+  generatedAt: z.number().int().positive()
+});
+
 // src/lib/api.ts
 var DEFAULT_API_URL = "https://api.tokenrats.com";
 function isTransient(status) {
@@ -4334,7 +4412,7 @@ var ApiClient = class {
   headers() {
     const h = { "Content-Type": "application/json" };
     if (this.token) {
-      h["Authorization"] = `Bearer ${this.token}`;
+      h.Authorization = `Bearer ${this.token}`;
     }
     return h;
   }
@@ -4354,7 +4432,7 @@ var ApiClient = class {
       }
       attempt++;
       if (attempt <= maxRetries) {
-        await sleep(1e3 * Math.pow(2, attempt - 1));
+        await sleep(1e3 * 2 ** (attempt - 1));
       }
     }
     throw lastErr;
@@ -4421,7 +4499,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 function tokenDir() {
-  const xdgConfig = process.env["XDG_CONFIG_HOME"];
+  const xdgConfig = process.env.XDG_CONFIG_HOME;
   const base = xdgConfig ?? path.join(os.homedir(), ".config");
   return path.join(base, "token-rats");
 }
@@ -4560,7 +4638,7 @@ async function loginCommand(opts) {
   const codeMatch = verificationUrl.match(/[?&]code=([A-Z0-9-]+)/);
   const code = codeMatch?.[1] ?? "";
   console.log("");
-  console.log(`  Open this URL to sign in:`);
+  console.log("  Open this URL to sign in:");
   console.log(`  \x1B[1m\x1B[36m${verificationUrl}\x1B[0m`);
   if (code) {
     console.log(`  Code: \x1B[1m${code}\x1B[0m`);
@@ -4713,13 +4791,13 @@ function parseClaudeCode(input) {
     }
     if (typeof event !== "object" || event === null) continue;
     const ev = event;
-    const sidCamel = ev["sessionId"];
-    const sidSnake = ev["session_id"];
+    const sidCamel = ev.sessionId;
+    const sidSnake = ev.session_id;
     const sessionId = typeof sidCamel === "string" ? sidCamel : typeof sidSnake === "string" ? sidSnake : null;
     if (!sessionId) continue;
-    const rawTs = ev["timestamp"];
+    const rawTs = ev.timestamp;
     let timestamp = 0;
-    if (typeof rawTs === "number" && isFinite(rawTs)) {
+    if (typeof rawTs === "number" && Number.isFinite(rawTs)) {
       timestamp = rawTs;
     } else if (typeof rawTs === "string") {
       const parsed = Date.parse(rawTs);
@@ -4741,18 +4819,18 @@ function parseClaudeCode(input) {
       if (acc.startedAt === 0 || timestamp < acc.startedAt) acc.startedAt = timestamp;
       if (timestamp > acc.endedAt) acc.endedAt = timestamp;
     }
-    if (ev["type"] !== "assistant") continue;
-    const message = ev["message"];
+    if (ev.type !== "assistant") continue;
+    const message = ev.message;
     if (typeof message !== "object" || message === null) continue;
     const msg = message;
-    if (typeof msg["model"] === "string" && msg["model"].length > 0) {
-      acc.model = msg["model"];
+    if (typeof msg.model === "string" && msg.model.length > 0) {
+      acc.model = msg.model;
     }
-    const usage = msg["usage"];
+    const usage = msg.usage;
     if (typeof usage === "object" && usage !== null) {
       const u = usage;
-      const inputTokens = toNonNegInt(u["input_tokens"]);
-      const outputTokens = toNonNegInt(u["output_tokens"]);
+      const inputTokens = toNonNegInt(u.input_tokens);
+      const outputTokens = toNonNegInt(u.output_tokens);
       acc.inTokens += inputTokens;
       acc.outTokens += outputTokens;
     }
@@ -4786,7 +4864,7 @@ function parseClaudeCode(input) {
   return results;
 }
 function toNonNegInt(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
+  if (typeof v !== "number" || !Number.isFinite(v)) return 0;
   return Math.max(0, Math.floor(v));
 }
 
@@ -4811,14 +4889,14 @@ function parseCodex(input) {
     }
     if (typeof event !== "object" || event === null) continue;
     const ev = event;
-    const ts = parseTimestamp(ev["timestamp"]);
-    const type = typeof ev["type"] === "string" ? ev["type"] : null;
-    const payload = typeof ev["payload"] === "object" && ev["payload"] !== null ? ev["payload"] : null;
+    const ts = parseTimestamp(ev.timestamp);
+    const type = typeof ev.type === "string" ? ev.type : null;
+    const payload = typeof ev.payload === "object" && ev.payload !== null ? ev.payload : null;
     if (type === "session_meta" && payload) {
-      const id = typeof payload["id"] === "string" ? payload["id"] : null;
+      const id = typeof payload.id === "string" ? payload.id : null;
       if (!id) continue;
       currentSessionId = id;
-      const metaTs = parseTimestamp(payload["timestamp"]) || ts;
+      const metaTs = parseTimestamp(payload.timestamp) || ts;
       const acc2 = upsert(sessions, id);
       if (metaTs > 0 && (acc2.startedAt === 0 || metaTs < acc2.startedAt)) {
         acc2.startedAt = metaTs;
@@ -4832,20 +4910,20 @@ function parseCodex(input) {
       if (acc.startedAt === 0) acc.startedAt = ts;
       if (ts > acc.endedAt) acc.endedAt = ts;
     }
-    if (type === "turn_context" && payload && typeof payload["model"] === "string") {
-      acc.model = payload["model"];
+    if (type === "turn_context" && payload && typeof payload.model === "string") {
+      acc.model = payload.model;
       continue;
     }
-    if (type === "event_msg" && payload && payload["type"] === "token_count") {
-      const info2 = payload["info"];
+    if (type === "event_msg" && payload && payload.type === "token_count") {
+      const info2 = payload.info;
       if (typeof info2 !== "object" || info2 === null) continue;
-      const total = info2["total_token_usage"];
+      const total = info2.total_token_usage;
       if (typeof total !== "object" || total === null) continue;
       const t = total;
-      const inputTotal = toNonNegInt2(t["input_tokens"]);
-      const cachedInput = toNonNegInt2(t["cached_input_tokens"]);
-      const output = toNonNegInt2(t["output_tokens"]);
-      const reasoning = toNonNegInt2(t["reasoning_output_tokens"]);
+      const inputTotal = toNonNegInt2(t.input_tokens);
+      const cachedInput = toNonNegInt2(t.cached_input_tokens);
+      const output = toNonNegInt2(t.output_tokens);
+      const reasoning = toNonNegInt2(t.reasoning_output_tokens);
       acc.inTokens = Math.max(0, inputTotal - cachedInput);
       acc.outTokens = output + reasoning;
     }
@@ -4857,13 +4935,7 @@ function parseCodex(input) {
     if (startedAt <= 0 || endedAt <= 0) continue;
     const model = acc.model.length > 0 ? acc.model : "unknown";
     const { costUsdCents } = priceOf(model, acc.inTokens, acc.outTokens);
-    const dedupeKey = computeDedupeKey(
-      "codex",
-      model,
-      startedAt,
-      acc.inTokens,
-      acc.outTokens
-    );
+    const dedupeKey = computeDedupeKey("codex", model, startedAt, acc.inTokens, acc.outTokens);
     results.push({
       id: `codex:${acc.sessionId}`,
       source: "codex",
@@ -4894,7 +4966,7 @@ function upsert(map, sessionId) {
   return acc;
 }
 function parseTimestamp(v) {
-  if (typeof v === "number" && isFinite(v)) return v;
+  if (typeof v === "number" && Number.isFinite(v)) return v;
   if (typeof v === "string") {
     const parsed = Date.parse(v);
     if (!Number.isNaN(parsed)) return parsed;
@@ -4902,26 +4974,21 @@ function parseTimestamp(v) {
   return 0;
 }
 function toNonNegInt2(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
+  if (typeof v !== "number" || !Number.isFinite(v)) return 0;
   return Math.max(0, Math.floor(v));
 }
 
 // ../parsers/src/cursor.ts
-var CURSOR_MODEL_MAP = {
-  // Claude models — Cursor uses abbreviated names without date suffixes
-  "claude-3.5-sonnet": "claude-3-5-sonnet-20241022",
-  "claude-3-5-sonnet": "claude-3-5-sonnet-20241022",
-  "claude-3.5-haiku": "claude-3-5-haiku-20241022",
-  "claude-3-5-haiku": "claude-3-5-haiku-20241022",
-  "claude-3.5-opus": "claude-3-opus-20240229",
-  "claude-3-opus": "claude-3-opus-20240229",
-  "claude-3-sonnet": "claude-3-sonnet-20240229",
-  "claude-3-haiku": "claude-3-haiku-20240307",
-  // GPT models — Cursor may omit date suffixes
-  "gpt-4o-mini": "gpt-4o-mini",
-  "gpt-4o": "gpt-4o",
-  "gpt-4-turbo": "gpt-4-turbo"
+var ESTIMATES = {
+  composer: { inTokens: 1e4, outTokens: 2e3, model: "cursor-composer" }
+  // "tab" deliberately omitted — see file header.
 };
+var INPUT_USD_PER_MTOK = 3;
+var OUTPUT_USD_PER_MTOK = 15;
+function estimatedCostCents(inTokens, outTokens) {
+  const dollars = inTokens / 1e6 * INPUT_USD_PER_MTOK + outTokens / 1e6 * OUTPUT_USD_PER_MTOK;
+  return Math.round(dollars * 100);
+}
 function parseCursor(input) {
   let text;
   if (typeof input === "string") {
@@ -4942,15 +5009,15 @@ function parseCursor(input) {
     const row = raw;
     const id = typeof row["id"] === "string" ? row["id"] : null;
     if (!id) continue;
-    const rawModel = typeof row["model"] === "string" ? row["model"] : "";
-    const model = rawModel.length > 0 ? CURSOR_MODEL_MAP[rawModel] ?? rawModel : "unknown";
-    const inTokens = toNonNegInt3(row["promptTokens"]);
-    const outTokens = toNonNegInt3(row["completionTokens"]);
-    const startedAt = typeof row["startedAt"] === "number" && isFinite(row["startedAt"]) && row["startedAt"] > 0 ? row["startedAt"] : null;
-    const endedAt = typeof row["endedAt"] === "number" && isFinite(row["endedAt"]) && row["endedAt"] > 0 ? row["endedAt"] : null;
-    if (startedAt === null || endedAt === null) continue;
-    const { costUsdCents } = priceOf(model, inTokens, outTokens);
-    const dedupeKey = computeDedupeKey("cursor", model, startedAt, inTokens, outTokens);
+    const type = typeof row["type"] === "string" ? row["type"] : null;
+    if (!type) continue;
+    const unixMs = typeof row["unixMs"] === "number" && isFinite(row["unixMs"]) && row["unixMs"] > 0 ? row["unixMs"] : null;
+    if (unixMs === null) continue;
+    const estimate = ESTIMATES[type];
+    if (!estimate) continue;
+    const { inTokens, outTokens, model } = estimate;
+    const costUsdCents = estimatedCostCents(inTokens, outTokens);
+    const dedupeKey = computeDedupeKey("cursor", model, unixMs, inTokens, outTokens);
     results.push({
       id: `cursor:${id}`,
       source: "cursor",
@@ -4958,128 +5025,167 @@ function parseCursor(input) {
       inTokens,
       outTokens,
       costUsdCents,
-      startedAt,
-      endedAt,
+      startedAt: unixMs,
+      endedAt: unixMs,
       dedupeKey
     });
   }
   return results;
 }
-function toNonNegInt3(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
-  return Math.max(0, Math.floor(v));
-}
 
 // src/lib/cursor-extract.ts
-async function tryNodeSqlite(dbPath) {
-  let DatabaseConstructor;
+import { existsSync, readdirSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+function cursorWorkspaceStorageDir() {
+  const home = homedir2();
+  const rel = join2("Cursor", "User", "workspaceStorage");
+  if (process.platform === "darwin") {
+    return join2(home, "Library", "Application Support", rel);
+  }
+  if (process.platform === "win32") {
+    const appData = process.env["APPDATA"] ?? join2(home, "AppData", "Roaming");
+    return join2(appData, rel);
+  }
+  const xdgConfig = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  return join2(xdgConfig, rel);
+}
+function discoverWorkspaceDbs() {
+  const root = cursorWorkspaceStorageDir();
+  if (!existsSync(root)) return [];
+  const out = [];
+  for (const entry of readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const candidate = join2(root, entry.name, "state.vscdb");
+    if (existsSync(candidate)) out.push(candidate);
+  }
+  return out;
+}
+async function openDb(dbPath) {
   try {
     const mod = await import("node:sqlite");
-    DatabaseConstructor = mod.DatabaseSync;
-    if (!DatabaseConstructor) return null;
+    const DatabaseSync = mod.DatabaseSync;
+    if (DatabaseSync) {
+      const db = new DatabaseSync(dbPath, { readOnly: true });
+      return {
+        exec: (sql) => {
+          const stmt = db.prepare(sql);
+          const rows = stmt.all();
+          if (rows.length === 0) return [];
+          const columns = Object.keys(rows[0]);
+          return [
+            {
+              columns,
+              values: rows.map((r) => columns.map((c2) => r[c2]))
+            }
+          ];
+        },
+        close: () => db.close()
+      };
+    }
   } catch {
-    return null;
   }
-  return readWithDb(() => new DatabaseConstructor(dbPath, { readOnly: true }));
-}
-async function tryBetterSqlite3(dbPath) {
-  let Database;
   try {
-    const mod = await import("better-sqlite3");
-    Database = mod.default ?? mod;
+    const sqlJs = await import("sql.js");
+    const initSqlJs = sqlJs.default ?? sqlJs;
+    const SQL = await initSqlJs();
+    const bytes = await readFile(dbPath);
+    return new SQL.Database(new Uint8Array(bytes));
   } catch {
-    return null;
   }
-  return readWithDb(() => new Database(dbPath, { readonly: true, fileMustExist: true }));
-}
-function readWithDb(factory) {
-  let db = null;
   try {
-    db = factory();
-    const rows = tryItemTable(db) ?? tryDirectTable(db) ?? [];
-    return rows;
+    const mod = await import("better-sqlite3");
+    const Database = mod.default ?? mod;
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    return {
+      exec: (sql) => {
+        const stmt = db.prepare(sql);
+        const rows = stmt.all();
+        if (rows.length === 0) return [];
+        const columns = Object.keys(rows[0]);
+        return [
+          {
+            columns,
+            values: rows.map((r) => columns.map((c2) => r[c2]))
+          }
+        ];
+      },
+      close: () => db.close()
+    };
   } catch {
     return null;
-  } finally {
-    try {
-      db?.close();
-    } catch {
-    }
   }
 }
-function tryItemTable(db) {
+async function readGenerationsFromDb(dbPath) {
+  const db = await openDb(dbPath);
+  if (!db) return [];
   try {
-    const stmt = db.prepare("SELECT value FROM ItemTable WHERE key = 'aiRequests'");
-    const rows = stmt.all();
-    if (rows.length === 0) return null;
-    const raw = rows[0]?.value;
-    if (typeof raw !== "string") return null;
+    const res = db.exec(`SELECT value FROM ItemTable WHERE key = 'aiService.generations'`);
+    if (res.length === 0 || res[0].values.length === 0) return [];
+    const raw = res[0].values[0][0];
+    if (typeof raw !== "string") return [];
     let parsed;
     try {
       parsed = JSON.parse(raw);
     } catch {
-      return null;
-    }
-    if (!Array.isArray(parsed)) return null;
-    return normalizeRows(parsed);
+      return [];
+    }
+    if (!Array.isArray(parsed)) return [];
+    const out = [];
+    for (const item of parsed) {
+      if (typeof item !== "object" || item === null) continue;
+      const r = item;
+      const id = typeof r["generationUUID"] === "string" ? r["generationUUID"] : null;
+      const type = typeof r["type"] === "string" ? r["type"] : null;
+      const unixMs = typeof r["unixMs"] === "number" && isFinite(r["unixMs"]) && r["unixMs"] > 0 ? r["unixMs"] : null;
+      if (!id || !type || unixMs === null) continue;
+      out.push({ id, type, unixMs });
+    }
+    return out;
   } catch {
-    return null;
-  }
-}
-function tryDirectTable(db) {
-  try {
-    const stmt = db.prepare(
-      `SELECT id, model,
-              prompt_tokens as promptTokens, completion_tokens as completionTokens,
-              started_at as startedAt, ended_at as endedAt
-       FROM cursor_requests
-       ORDER BY started_at DESC
-       LIMIT 50000`
-    );
-    const rows = stmt.all();
-    return normalizeRows(rows);
-  } catch {
-    return null;
+    return [];
+  } finally {
+    try {
+      db.close();
+    } catch {
+    }
   }
 }
-function normalizeRows(rows) {
-  const results = [];
-  for (const raw of rows) {
-    if (typeof raw !== "object" || raw === null) continue;
-    const r = raw;
-    const id = typeof r["id"] === "string" ? r["id"] : null;
-    if (!id) continue;
-    const model = typeof r["model"] === "string" ? r["model"] : "unknown";
-    const promptTokens = toNonNegInt4(r["promptTokens"] ?? r["prompt_tokens"]);
-    const completionTokens = toNonNegInt4(r["completionTokens"] ?? r["completion_tokens"]);
-    const startedAt = toPositiveMs(r["startedAt"] ?? r["started_at"]);
-    const endedAt = toPositiveMs(r["endedAt"] ?? r["ended_at"]);
-    if (startedAt === null || endedAt === null) continue;
-    results.push({ id, model, promptTokens, completionTokens, startedAt, endedAt });
+async function extractCursorGenerations() {
+  const dbPaths = discoverWorkspaceDbs();
+  if (dbPaths.length === 0) {
+    return {
+      rows: [],
+      skipped: null,
+      dbCount: 0
+    };
   }
-  return results;
-}
-function toNonNegInt4(v) {
-  if (typeof v !== "number" || !isFinite(v)) return 0;
-  return Math.max(0, Math.floor(v));
-}
-function toPositiveMs(v) {
-  if (typeof v !== "number" || !isFinite(v) || v <= 0) return null;
-  return v;
-}
-async function readCursorDb(dbPath) {
-  const fromNodeSqlite = await tryNodeSqlite(dbPath);
-  if (fromNodeSqlite !== null) {
-    return { rows: fromNodeSqlite, skipped: null };
+  const seen2 = /* @__PURE__ */ new Set();
+  const rows = [];
+  let openFailures = 0;
+  for (const p of dbPaths) {
+    let perDb = [];
+    try {
+      perDb = await readGenerationsFromDb(p);
+    } catch {
+      openFailures++;
+      continue;
+    }
+    for (const r of perDb) {
+      if (seen2.has(r.id)) continue;
+      seen2.add(r.id);
+      rows.push(r);
+    }
   }
-  const fromBetter = await tryBetterSqlite3(dbPath);
-  if (fromBetter !== null) {
-    return { rows: fromBetter, skipped: null };
+  if (rows.length === 0 && openFailures === dbPaths.length) {
+    return {
+      rows: [],
+      dbCount: dbPaths.length,
+      skipped: "Could not open any Cursor workspace DB (sqlite drivers unavailable). Run `npx token-rats install-cursor` for native speed, or upgrade to Node \u226522.5."
+    };
   }
-  return {
-    rows: [],
-    skipped: "Could not open Cursor DB (no sqlite driver available). Skipping Cursor source."
-  };
+  return { rows, dbCount: dbPaths.length, skipped: null };
 }
 
 // src/lib/discover.ts
@@ -5103,7 +5209,7 @@ function findJsonlFiles(dir) {
 function claudeCodeProjectsDir() {
   const home = os2.homedir();
   if (process.platform === "win32") {
-    const profile = process.env["USERPROFILE"] ?? home;
+    const profile = process.env.USERPROFILE ?? home;
     return path2.join(profile, ".claude", "projects");
   }
   return path2.join(home, ".claude", "projects");
@@ -5116,9 +5222,9 @@ function codexSessionsDirs() {
   const home = os2.homedir();
   const candidates = [];
   if (process.platform === "win32") {
-    const profile = process.env["USERPROFILE"] ?? home;
+    const profile = process.env.USERPROFILE ?? home;
     candidates.push(path2.join(profile, ".codex", "sessions"));
-    const appData = process.env["APPDATA"] ?? path2.join(profile, "AppData", "Roaming");
+    const appData = process.env.APPDATA ?? path2.join(profile, "AppData", "Roaming");
     candidates.push(path2.join(appData, "Codex", "sessions"));
   } else {
     candidates.push(path2.join(home, ".codex", "sessions"));
@@ -5152,23 +5258,6 @@ function discoverCodexFiles() {
   }
   return out;
 }
-function cursorDbPath() {
-  const home = os2.homedir();
-  const rel = path2.join("Cursor", "User", "globalStorage", "state.vscdb");
-  if (process.platform === "darwin") {
-    return path2.join(home, "Library", "Application Support", rel);
-  }
-  if (process.platform === "win32") {
-    const appData = process.env["APPDATA"] ?? path2.join(home, "AppData", "Roaming");
-    return path2.join(appData, rel);
-  }
-  const xdgConfig = process.env["XDG_CONFIG_HOME"] ?? path2.join(home, ".config");
-  return path2.join(xdgConfig, rel);
-}
-function discoverCursorDb() {
-  const p = cursorDbPath();
-  return fs2.existsSync(p) ? p : null;
-}
 
 // src/commands/sync.ts
 var BATCH_SIZE = 500;
@@ -5260,25 +5349,26 @@ async function syncCommand(opts) {
     }
   }
   const cursorSessions = [];
-  const cursorDbPath2 = discoverCursorDb();
-  if (cursorDbPath2) {
-    if (opts.verbose) info(`Found Cursor DB at ${cursorDbPath2}`);
-    const { rows, skipped } = await readCursorDb(cursorDbPath2);
-    if (skipped) {
-      warn(skipped);
-    } else if (rows.length > 0) {
-      try {
-        const records = parseCursor(JSON.stringify(rows));
-        cursorSessions.push(...records);
-        if (opts.verbose) dim(`  Cursor DB: ${records.length} session(s)`);
-      } catch {
-        if (opts.verbose) warn("Failed to parse Cursor rows \u2014 skipping");
+  const { rows, skipped, dbCount } = await extractCursorGenerations();
+  if (skipped) {
+    warn(skipped);
+  } else if (dbCount === 0) {
+    if (opts.verbose) info("No Cursor workspace storage found \u2014 skipping Cursor source");
+  } else if (rows.length > 0) {
+    if (opts.verbose) info(`Scanned ${dbCount} Cursor workspace DB(s)`);
+    try {
+      const records = parseCursor(JSON.stringify(rows));
+      cursorSessions.push(...records);
+      if (opts.verbose) {
+        dim(
+          `  Cursor: ${rows.length} generation event(s) \u2192 ${records.length} session(s) (tokens estimated, see help)`
+        );
       }
-    } else if (opts.verbose) {
-      dim("  Cursor DB: 0 rows found");
+    } catch {
+      if (opts.verbose) warn("Failed to parse Cursor rows \u2014 skipping");
     }
-  } else {
-    if (opts.verbose) info("Cursor DB not found \u2014 skipping Cursor source");
+  } else if (opts.verbose) {
+    dim(`  Scanned ${dbCount} Cursor workspace DB(s): no AI generations found`);
   }
   const mergedClaude = mergeBySessionId(claudeSessions);
   if (opts.verbose && mergedClaude.length !== claudeSessions.length) {
@@ -5452,7 +5542,9 @@ async function watchCommand(opts) {
   }, debounceMs);
   let cleanup = null;
   try {
-    const chokidar = await new Function("m", "return import(m)")("chokidar");
+    const chokidar = await new Function("m", "return import(m)")(
+      "chokidar"
+    );
     const watcher = chokidar.watch(`${dir}/**/*.jsonl`, {
       ignoreInitial: true,
       persistent: true,
@@ -5504,7 +5596,7 @@ async function watchCommand(opts) {
           const watcher = watch(dir, { recursive: true, signal: controller.signal });
           for await (const event of watcher) {
             const filename = event.filename;
-            if (filename && filename.endsWith(".jsonl")) {
+            if (filename?.endsWith(".jsonl")) {
               const fullPath = `${dir}/${filename}`;
               onChanged(fullPath);
             }
@@ -5550,7 +5642,7 @@ async function whoamiCommand(opts) {
 
 // src/index.ts
 function getVersion() {
-  return "0.0.1";
+  return "0.0.4";
 }
 function printHelp() {
   console.log(`
@@ -5560,12 +5652,14 @@ function printHelp() {
   token-rats <command> [flags]
 
 \x1B[1mCommands:\x1B[0m
-  login      Authenticate with Token Rats (opens browser)
-  sync       Read local Claude Code + Cursor logs and upload counts
-  watch      Watch logs in real-time; upload new sessions as they appear
-  whoami     Show the currently signed-in account
-  logout     Clear your stored credentials
-  help       Show this help message
+  login           Authenticate with Token Rats (opens browser)
+  sync            Read local Claude Code + Cursor logs and upload counts
+  watch           Watch logs in real-time; upload new sessions as they appear
+  whoami          Show the currently signed-in account
+  logout          Clear your stored credentials
+  install-cursor  Install better-sqlite3 globally for faster Cursor reads
+                  (sql.js works out of the box \u2014 this is opt-in speed-up)
+  help            Show this help message
 
 \x1B[1mFlags (all commands):\x1B[0m
   --api-url <url>   Override API URL (default: https://api.tokenrats.com)
@@ -5583,6 +5677,12 @@ function printHelp() {
   The parser source is in packages/parsers/. We literally can't read
   what you typed.
 
+\x1B[1mCursor notes:\x1B[0m
+  Cursor doesn't store token counts locally, so per-request tokens
+  are *estimated* (10k in / 2k out per composer turn, claude-3-5-sonnet
+  rates). Tab autocomplete is excluded. Numbers are comparable across
+  Token Rats users but won't match cursor.com to the token.
+
 \x1B[1mExamples:\x1B[0m
   npx token-rats login
   npx token-rats sync
@@ -5649,9 +5749,12 @@ async function main() {
     case "logout":
       logoutCommand();
       break;
+    case "install-cursor":
+      await installCursorCommand();
+      break;
     default:
       console.error(`\x1B[31mUnknown command: ${command}\x1B[0m`);
-      console.error(`Run \x1B[1mtoken-rats help\x1B[0m for a list of commands.`);
+      console.error("Run \x1B[1mtoken-rats help\x1B[0m for a list of commands.");
       process.exit(1);
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "token-rats",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Sync your Claude Code + Cursor token usage to your Token Rats leaderboard.",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "type": "module",
   "bin": {
     "token-rats": "./dist/index.js"
@@ -26,7 +26,6 @@
     "prepublishOnly": "node build.mjs"
   },
   "optionalDependencies": {
-    "better-sqlite3": "^9.4.3",
     "chokidar": "^3.6.0",
     "clipboardy": "^4.0.0",
     "open": "^10.1.0"
@@ -37,9 +36,13 @@
     "@token-rats/pricing": "workspace:*",
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "22.10.2",
+    "@types/sql.js": "^1.4.11",
     "esbuild": "^0.24.2",
     "tsx": "4.19.2",
     "typescript": "5.7.2",
     "vitest": "2.1.8"
+  },
+  "dependencies": {
+    "sql.js": "^1.14.1"
   }
 }