@neuralmindlabs/tokn 0.1.0

package/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-49.64" y="2.03" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-45.045" y="20.029" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-43.513" y="21.178" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="15.756" y="-17.901" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-27.636" y="-22.853" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="20.116" y="-38.415" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="24.641" y="-11.323" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="8.244" y="-2.416" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="18.713" y="10.588" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter></defs></svg>

package/public/icons.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg">
+  <symbol id="bluesky-icon" viewBox="0 0 16 17">
+    <g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
+    <defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
+  </symbol>
+  <symbol id="discord-icon" viewBox="0 0 20 19">
+    <path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
+  </symbol>
+  <symbol id="documentation-icon" viewBox="0 0 21 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
+  </symbol>
+  <symbol id="github-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
+  </symbol>
+  <symbol id="social-icon" viewBox="0 0 20 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
+  </symbol>
+  <symbol id="x-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
+  </symbol>
+</svg>

package/scripts/validate.ts

@@ -0,0 +1,122 @@
+/**
+ * Cross-check our Claude Code parsing + pricing against ccusage
+ * (independent implementation over the same JSONL files).
+ * Run: npm run validate
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { parseClaudeSession } from 'tokn';
+import { parseCodexSession } from 'tokn';
+import { eventsToDays } from 'tokn';
+import type { UsageEvent } from 'tokn';
+
+function* jsonlFiles(dir: string): Generator<string> {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, entry.name);
+    if (entry.isDirectory()) yield* jsonlFiles(p);
+    else if (entry.name.endsWith('.jsonl')) yield p;
+  }
+}
+
+const dedupe = new Set<string>();
+const events: UsageEvent[] = [];
+let files = 0;
+for (const file of jsonlFiles(join(homedir(), '.claude', 'projects'))) {
+  files++;
+  try {
+    events.push(...parseClaudeSession(readFileSync(file, 'utf8'), dedupe).events);
+  } catch {
+    /* unreadable file — skip */
+  }
+}
+
+// Codex self-check: our per-event deltas must sum to each session's own
+// cumulative counter. (ccusage double-counts Codex — token_count events are
+// emitted twice — so it can't serve as the reference here.)
+let codexMismatches = 0;
+let codexEvents = 0;
+for (const file of jsonlFiles(join(homedir(), '.codex', 'sessions'))) {
+  files++;
+  let content: string;
+  try {
+    content = readFileSync(file, 'utf8');
+  } catch {
+    continue;
+  }
+  const parsed = parseCodexSession(content).events;
+  codexEvents += parsed.length;
+  let finalTotal = 0;
+  let resets = 0;
+  let prevTotal = -1;
+  for (const line of content.split('\n')) {
+    if (!line.includes('token_count')) continue;
+    try {
+      const t = JSON.parse(line).payload?.info?.total_token_usage;
+      if (!t) continue;
+      if (t.total_tokens < prevTotal) resets++;
+      prevTotal = t.total_tokens;
+      finalTotal = t.total_tokens;
+    } catch {
+      /* skip */
+    }
+  }
+  const ourTotal = parsed.reduce((s, e) => s + e.inputTokens + e.outputTokens, 0);
+  // with counter resets the session total is unrecoverable from the last value alone
+  if (resets === 0 && finalTotal > 0 && ourTotal !== finalTotal) {
+    codexMismatches++;
+    console.error(`codex mismatch ${file}: ours ${ourTotal} vs counter ${finalTotal}`);
+  }
+}
+console.log(`codex: ${codexEvents} events across sessions, ${codexMismatches} counter mismatches`);
+console.log(`parsed ${files} files, ${events.length} claude usage events`);
+
+const days = eventsToDays(events);
+const ours = new Map<string, number>();
+for (const [date, byModel] of Object.entries(days)) {
+  let cost = 0;
+  for (const t of Object.values(byModel)) cost += t.costUSD;
+  ours.set(date, cost);
+}
+
+console.log('running ccusage (this downloads the package on first run)...');
+const raw = execSync('npx --yes ccusage@latest daily --json', {
+  encoding: 'utf8',
+  maxBuffer: 64 * 1024 * 1024,
+});
+const theirs = JSON.parse(raw);
+
+const unpriced = new Map<string, number>();
+for (const byModel of Object.values(days)) {
+  for (const [model, t] of Object.entries(byModel)) {
+    if (t.unpricedEvents > 0) unpriced.set(model, (unpriced.get(model) ?? 0) + t.unpricedEvents);
+  }
+}
+if (unpriced.size > 0) console.log('models missing pricing:', Object.fromEntries(unpriced));
+
+let worst = 0;
+let compared = 0;
+const rows: string[] = [];
+for (const d of theirs.daily ?? []) {
+  const ourCost = ours.get(d.period ?? d.date) ?? 0;
+  // only Claude Code is comparable: ccusage double-counts codex, and we
+  // don't parse its other agents (gemini, openclaw)
+  const theirCost = (d.modelBreakdowns ?? [])
+    .filter((mb: any) => typeof mb.modelName === 'string' && mb.modelName.startsWith('claude-'))
+    .reduce((s: number, mb: any) => s + (mb.cost ?? 0), 0);
+  if (theirCost < 0.01 && ourCost < 0.01) continue;
+  compared++;
+  const diff = theirCost === 0 ? (ourCost === 0 ? 0 : 1) : Math.abs(ourCost - theirCost) / theirCost;
+  worst = Math.max(worst, diff);
+  rows.push(
+    `${d.period ?? d.date}  ours $${ourCost.toFixed(4).padStart(10)}  ccusage $${theirCost.toFixed(4).padStart(10)}  diff ${(diff * 100).toFixed(2)}%`,
+  );
+}
+console.log(rows.slice(-15).join('\n'));
+console.log(`\ncompared ${compared} days, worst relative diff ${(worst * 100).toFixed(2)}%`);
+if (worst > 0.02) {
+  console.error('FAIL: divergence above 2% tolerance');
+  process.exit(1);
+}
+console.log('PASS: within 2% of ccusage');

package/src/App.tsx

@@ -0,0 +1,12 @@
+import { useEffect } from 'react';
+import Popover from './ui/Popover.tsx';
+import Dashboard from './ui/Dashboard.tsx';
+import { initTheme } from './lib/refresh.ts';
+
+export default function App() {
+  useEffect(() => {
+    initTheme();
+  }, []);
+  const view = new URLSearchParams(window.location.search).get('view');
+  return view === 'dashboard' ? <Dashboard /> : <Popover />;
+}

package/src/assets/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="77" height="47" fill="none" aria-labelledby="vite-logo-title" viewBox="0 0 77 47"><title id="vite-logo-title">Vite</title><style>.parenthesis{fill:#000}@media (prefers-color-scheme:dark){.parenthesis{fill:#fff}}</style><path fill="#9135ff" d="M40.151 45.71c-.663.844-2.02.374-2.02-.699V34.708a2.26 2.26 0 0 0-2.262-2.262H24.493c-.92 0-1.457-1.04-.92-1.788l7.479-10.471c1.07-1.498 0-3.578-1.842-3.578H15.443c-.92 0-1.456-1.04-.92-1.788l9.696-13.576c.213-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.472c-1.07 1.497 0 3.578 1.842 3.578h11.376c.944 0 1.474 1.087.89 1.83L40.153 45.712z"/><mask id="a" width="48" height="47" x="14" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M40.047 45.71c-.663.843-2.02.374-2.02-.699V34.708a2.26 2.26 0 0 0-2.262-2.262H24.389c-.92 0-1.457-1.04-.92-1.788l7.479-10.472c1.07-1.497 0-3.578-1.842-3.578H15.34c-.92 0-1.456-1.04-.92-1.788l9.696-13.575c.213-.297.556-.474.92-.474H53.93c.92 0 1.456 1.04.92 1.788L47.37 13.03c-1.07 1.498 0 3.578 1.842 3.578h11.376c.944 0 1.474 1.088.89 1.831L40.049 45.712z"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#eee6ff" rx="5.508" ry="14.704" transform="rotate(269.814 20.96 11.29)scale(-1 1)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#eee6ff" rx="10.399" ry="29.851" transform="rotate(89.814 -16.902 -8.275)scale(1 -1)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#8900ff" rx="5.508" ry="30.487" transform="rotate(89.814 -19.197 -7.127)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#8900ff" rx="5.508" ry="30.599" transform="rotate(89.814 -25.928 4.177)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#8900ff" rx="5.508" ry="30.599" transform="rotate(89.814 -25.738 5.52)scale(1 -1)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#eee6ff" rx="14.072" ry="22.078" transform="rotate(93.35 31.245 55.578)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#8900ff" rx="3.47" ry="21.501" transform="rotate(89.009 35.419 55.202)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#8900ff" rx="3.47" ry="21.501" transform="rotate(89.009 35.419 55.202)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx="14.592" cy="9.743" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(39.51 14.592 9.743)"/></g><g filter="url(#k)"><ellipse cx="61.728" cy="-5.321" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 61.728 -5.32)"/></g><g filter="url(#l)"><ellipse cx="55.618" cy="7.104" fill="#00c2ff" rx="5.971" ry="9.665" transform="rotate(37.892 55.618 7.104)"/></g><g filter="url(#m)"><ellipse cx="12.326" cy="39.103" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 12.326 39.103)"/></g><g filter="url(#n)"><ellipse cx="12.326" cy="39.103" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 12.326 39.103)"/></g><g filter="url(#o)"><ellipse cx="49.857" cy="30.678" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 49.857 30.678)"/></g><g filter="url(#p)"><ellipse cx="52.623" cy="33.171" fill="#00c2ff" rx="5.971" ry="15.297" transform="rotate(37.892 52.623 33.17)"/></g></g><path d="M6.919 0c-9.198 13.166-9.252 33.575 0 46.789h6.215c-9.25-13.214-9.196-33.623 0-46.789zm62.424 0h-6.215c9.198 13.166 9.252 33.575 0 46.789h6.215c9.25-13.214 9.196-33.623 0-46.789" class="parenthesis"/><defs><filter id="b" width="60.045" height="41.654" x="-5.564" y="16.92" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-40.407" y="-6.762" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-35.435" y="2.801" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-30.84" y="20.8" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-29.307" y="21.949" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="29.961" y="-17.13" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="37.754" y="3.055" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="37.754" y="3.055" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-13.43" y="-22.082" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="34.321" y="-37.644" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="38.847" y="-10.552" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-15.081" y="6.78" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-15.081" y="6.78" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="22.45" y="-1.645" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="32.919" y="11.36" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter></defs></svg>

package/src/index.css

@@ -0,0 +1,250 @@
+/* ————————————————————————————————————————————————————————————————
+   Tokn — "Terminal Ledger"
+   A dark-first developer-finance utility: every figure set in the
+   native monospace (SF Mono), hairline rules, tabular columns, one
+   restrained violet accent echoing the coin mark. Calm, precise,
+   glanceable. Light mode is the same ledger on paper.
+   ———————————————————————————————————————————————————————————————— */
+
+:root {
+  --sans: -apple-system, BlinkMacSystemFont, 'SF Pro Text', system-ui, sans-serif;
+  --mono: ui-monospace, 'SF Mono', 'JetBrains Mono', Menlo, monospace;
+  font-family: var(--sans);
+  font-size: 13px;
+  color-scheme: light dark;
+
+  /* paper */
+  --bg: #f1f1ef;
+  --card: #ffffff;
+  --text: #18181b;
+  --muted: #6b6b73;
+  --faint: #a6a6ad;
+  --border: rgba(0, 0, 0, 0.09);
+  --hairline: rgba(0, 0, 0, 0.06);
+  --hover: rgba(0, 0, 0, 0.035);
+  --accent: #6663e6;
+  --accent-soft: rgba(102, 99, 230, 0.1);
+  --shadow: 0 1px 2px rgba(20, 20, 25, 0.05), 0 10px 30px rgba(20, 20, 25, 0.07);
+}
+
+/* theme=system (default): follow the OS */
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme='light']) {
+    color-scheme: dark;
+    --bg: #131316;
+    --card: #1c1c20;
+    --text: #e8e8ec;
+    --muted: #8b8b94;
+    --faint: #55555e;
+    --border: rgba(255, 255, 255, 0.08);
+    --hairline: rgba(255, 255, 255, 0.055);
+    --hover: rgba(255, 255, 255, 0.04);
+    --accent: #8b87ff;
+    --accent-soft: rgba(139, 135, 255, 0.16);
+    --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 10px 30px rgba(0, 0, 0, 0.38);
+  }
+}
+/* explicit overrides from Settings */
+:root[data-theme='dark'] {
+  color-scheme: dark;
+  --bg: #131316;
+  --card: #1c1c20;
+  --text: #e8e8ec;
+  --muted: #8b8b94;
+  --faint: #55555e;
+  --border: rgba(255, 255, 255, 0.08);
+  --hairline: rgba(255, 255, 255, 0.055);
+  --hover: rgba(255, 255, 255, 0.04);
+  --accent: #8b87ff;
+  --accent-soft: rgba(139, 135, 255, 0.16);
+  --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 10px 30px rgba(0, 0, 0, 0.38);
+}
+:root[data-theme='light'] {
+  color-scheme: light;
+}
+
+* { box-sizing: border-box; }
+html, body, #root { margin: 0; padding: 0; }
+body {
+  color: var(--text);
+  background: transparent;
+  -webkit-font-smoothing: antialiased;
+  user-select: none;
+}
+
+.muted { color: var(--muted); }
+.small { font-size: 11px; }
+.right { text-align: right; }
+
+/* every money/token figure is monospace + tabular */
+.big {
+  font-family: var(--mono);
+  font-size: 27px;
+  font-weight: 600;
+  letter-spacing: -1px;
+  font-variant-numeric: tabular-nums;
+  line-height: 1.05;
+}
+.mid {
+  font-family: var(--mono);
+  font-size: 15px;
+  font-weight: 600;
+  letter-spacing: -0.4px;
+  font-variant-numeric: tabular-nums;
+}
+.dot { width: 7px; height: 7px; border-radius: 2px; display: inline-block; flex: none; }
+
+/* small-caps column heads */
+.sc, h2, th {
+  font-size: 10px;
+  font-weight: 600;
+  letter-spacing: 0.9px;
+  text-transform: uppercase;
+  color: var(--muted);
+}
+
+/* ————— popover: cards on the canvas ————— */
+.popover {
+  background: var(--bg);
+  border: 0.5px solid var(--border);
+  border-radius: 16px;
+  overflow: hidden;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 8px;
+  position: relative;
+}
+.pop-card {
+  background: var(--card);
+  border: 0.5px solid var(--hairline);
+  border-radius: 12px;
+  padding: 13px 14px;
+}
+.pop-hero { padding-bottom: 14px; }
+.pop-header { display: flex; justify-content: space-between; align-items: baseline; }
+.pop-tools { display: flex; flex-direction: column; gap: 10px; }
+.tool-row { display: flex; align-items: baseline; gap: 8px; }
+.tool-row .dot { align-self: center; }
+.tool-name { flex: none; font-weight: 500; }
+/* dotted leader carries the eye to the figure — the ledger touch */
+.leader {
+  flex: 1;
+  min-width: 12px;
+  border-bottom: 1px dotted var(--faint);
+  transform: translateY(-3px);
+  opacity: 0.6;
+}
+.tool-cost { font-family: var(--mono); font-weight: 600; min-width: 56px; text-align: right; font-variant-numeric: tabular-nums; letter-spacing: -0.3px; }
+.pop-chart .small { color: var(--muted); }
+.bars { display: flex; align-items: flex-end; gap: 3px; height: 60px; margin-top: 8px; }
+.bar-col { flex: 1; display: flex; flex-direction: column-reverse; gap: 1px; height: 100%; }
+.bar-col div { border-radius: 2px 2px 0 0; }
+.bar-labels { display: flex; justify-content: space-between; margin-top: 5px; font-family: var(--mono); font-variant-numeric: tabular-nums; }
+.pop-footer {
+  padding: 4px 8px 2px;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-top: auto;
+}
+.linkish { background: none; border: none; color: var(--accent); cursor: pointer; font-size: 12px; padding: 0; font-weight: 550; }
+.linkish:hover { text-decoration: underline; }
+
+/* ————— dashboard ————— */
+.dashboard {
+  background: var(--bg);
+  min-height: 100vh;
+  padding: 26px 30px 36px;
+  user-select: text;
+  position: relative;
+}
+.dash-header { display: flex; justify-content: space-between; align-items: flex-end; margin-bottom: 18px; }
+h1 { font-size: 21px; font-weight: 650; letter-spacing: -0.4px; margin: 0 0 3px; }
+h2 { margin: 0 0 10px; }
+.controls { display: flex; gap: 6px; }
+.seg {
+  background: var(--card);
+  border: 0.5px solid var(--border);
+  border-radius: 8px;
+  padding: 5px 13px;
+  cursor: pointer;
+  color: var(--text);
+  font-size: 12px;
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+  transition: background 120ms ease, color 120ms ease, border-color 120ms ease;
+}
+.seg:hover { background: var(--hover); }
+.seg.active { background: var(--accent); color: #fff; border-color: var(--accent); }
+
+.filters { display: flex; gap: 18px; margin-bottom: 12px; }
+.filter { display: flex; align-items: center; gap: 6px; cursor: pointer; font-size: 12.5px; font-weight: 500; }
+.filter input { accent-color: var(--accent); }
+
+.chart-box {
+  background: var(--card);
+  border: 0.5px solid var(--border);
+  border-radius: 12px;
+  padding: 14px 10px 6px;
+  margin-bottom: 18px;
+  box-shadow: var(--shadow);
+}
+
+.tables { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; margin-bottom: 18px; }
+.tables section {
+  background: var(--card);
+  border: 0.5px solid var(--border);
+  border-radius: 12px;
+  padding: 16px 18px;
+  box-shadow: var(--shadow);
+}
+table { width: 100%; border-collapse: collapse; font-size: 12.5px; }
+th { text-align: left; padding: 3px 0 6px; border-bottom: 0.5px solid var(--border); }
+th:not(:first-child), td:not(:first-child) { text-align: right; }
+td { padding: 5px 0; border-bottom: 0.5px solid var(--hairline); }
+td:not(:first-child) { font-family: var(--mono); font-variant-numeric: tabular-nums; letter-spacing: -0.3px; }
+tbody tr:last-child td { border-bottom: none; }
+td:first-child { max-width: 260px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+tbody tr { transition: background 120ms ease; }
+tbody tr:hover { background: var(--hover); }
+tfoot td { border-top: 1px solid var(--border); font-weight: 650; padding: 6px 0 2px; }
+.warn { color: #c98a1b; }
+
+/* ————— settings ————— */
+.settings {
+  background: var(--card);
+  border: 0.5px solid var(--border);
+  border-radius: 12px;
+  padding: 16px 18px;
+  box-shadow: var(--shadow);
+}
+.setting-row { display: flex; justify-content: space-between; align-items: center; gap: 24px; padding: 9px 0; }
+.setting-row + .setting-row { border-top: 0.5px solid var(--hairline); }
+.setting-name { font-weight: 550; }
+.cookie-input { display: flex; gap: 6px; flex: none; }
+.cookie-input input {
+  width: 260px;
+  background: var(--bg);
+  border: 0.5px solid var(--border);
+  border-radius: 8px;
+  padding: 6px 8px;
+  color: var(--text);
+  font-size: 12px;
+  font-family: var(--mono);
+}
+.cookie-input input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-soft); }
+.cookie-input button, .settings button {
+  background: var(--card);
+  border: 0.5px solid var(--border);
+  border-radius: 8px;
+  padding: 6px 12px;
+  cursor: pointer;
+  color: var(--text);
+  font-weight: 500;
+  transition: background 120ms ease;
+}
+.cookie-input button:hover, .settings button:hover { background: var(--hover); }
+.help-link { color: var(--accent); cursor: pointer; text-decoration: none; }
+.help-link:hover { text-decoration: underline; }

package/src/lib/refresh.ts

@@ -0,0 +1,134 @@
+import { invoke } from '@tauri-apps/api/core';
+import { emit } from '@tauri-apps/api/event';
+import { fetch as tauriFetch } from '@tauri-apps/plugin-http';
+import { load, type Store } from '@tauri-apps/plugin-store';
+import { buildRollups, fetchCursorUsage, localDate, fetchPrices, type CursorStatus, type DaysMap } from 'tokn';
+import type { DayRollup } from 'tokn';
+import { scan, type ScanState } from './scanner.ts';
+
+export type Theme = 'system' | 'light' | 'dark';
+
+export interface Settings {
+  cursorCookie: string;
+  refreshSec: number;
+  theme: Theme;
+}
+
+export interface AppData {
+  rollups: DayRollup[];
+  cursorStatus: CursorStatus | 'disabled';
+  lastRefresh: string;
+}
+
+export const ROLLUPS_EVENT = 'rollups-updated';
+
+let settingsStore: Store | null = null;
+let cacheStore: Store | null = null;
+
+export async function stores() {
+  settingsStore ??= await load('settings.json', { autoSave: true, defaults: {} });
+  cacheStore ??= await load('cache.json', { autoSave: false, defaults: {} });
+  return { settingsStore, cacheStore };
+}
+
+export async function getSettings(): Promise<Settings> {
+  const { settingsStore } = await stores();
+  return {
+    cursorCookie: (await settingsStore.get<string>('cursorCookie')) ?? '',
+    refreshSec: (await settingsStore.get<number>('refreshSec')) ?? 60,
+    theme: (await settingsStore.get<Theme>('theme')) ?? 'system',
+  };
+}
+
+/** Apply the theme to this window and keep it in sync with the store. */
+export async function initTheme() {
+  const { settingsStore } = await stores();
+  const apply = (theme: Theme | undefined) => {
+    const t = theme ?? 'system';
+    if (t === 'system') document.documentElement.removeAttribute('data-theme');
+    else document.documentElement.setAttribute('data-theme', t);
+  };
+  apply((await settingsStore.get<Theme>('theme')) ?? 'system');
+  await settingsStore.onKeyChange<Theme>('theme', apply);
+}
+
+export async function setSetting<K extends keyof Settings>(key: K, value: Settings[K]) {
+  const { settingsStore } = await stores();
+  await settingsStore.set(key, value);
+}
+
+export async function getCachedData(): Promise<AppData | null> {
+  const { cacheStore } = await stores();
+  return (await cacheStore.get<AppData>('data')) ?? null;
+}
+
+export function fmtUSD(n: number): string {
+  return `$${n.toFixed(2)}`;
+}
+
+/** Runs only in the popover window (always alive); dashboard just listens. */
+export function startRefreshLoop() {
+  let scanState: ScanState = {};
+  let cursorDays: DaysMap = {};
+  let cursorStatus: CursorStatus | 'disabled' = 'disabled';
+  let cursorFetchedAt = 0;
+  let running = false;
+  let booted = false;
+
+  const tick = async () => {
+    if (running) return;
+    running = true;
+    try {
+      const { cacheStore } = await stores();
+      if (!booted) {
+        booted = true;
+        scanState = (await cacheStore.get<ScanState>('scanState')) ?? {};
+        cursorDays = (await cacheStore.get<DaysMap>('cursorDays')) ?? {};
+      }
+      const settings = await getSettings();
+
+      await fetchPrices({ fetchImpl: tauriFetch });
+
+      const result = await scan(scanState);
+      scanState = result.state;
+
+      if (settings.cursorCookie && Date.now() - cursorFetchedAt > 10 * 60 * 1000) {
+        const cursor = await fetchCursorUsage(settings.cursorCookie, { fetchImpl: tauriFetch });
+        cursorStatus = cursor.status;
+        cursorFetchedAt = Date.now();
+        if (cursor.status === 'ok') {
+          cursorDays = cursor.days;
+          await cacheStore.set('cursorDays', cursorDays);
+        }
+      } else if (!settings.cursorCookie) {
+        cursorStatus = 'disabled';
+      }
+
+      const rollups = buildRollups([
+        ...result.sources,
+        { tool: 'cursor', days: cursorDays },
+      ]);
+      const data: AppData = {
+        rollups,
+        cursorStatus,
+        lastRefresh: new Date().toISOString(),
+      };
+
+      await cacheStore.set('scanState', scanState);
+      await cacheStore.set('data', data);
+      await cacheStore.save();
+
+      const today = rollups.find((r) => r.date === localDate(new Date().toISOString()));
+      await invoke('set_tray_title', { title: fmtUSD(today?.totalCostUSD ?? 0) });
+      await emit(ROLLUPS_EVENT, data);
+    } catch (e) {
+      console.error('refresh tick failed', e);
+    } finally {
+      running = false;
+    }
+  };
+
+  tick();
+  const timer = setInterval(tick, 60_000);
+  return () => clearInterval(timer);
+}