codex-token-tracker 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to `codex-token-tracker`. This project follows [Semantic Versioning](https://semver.org/).
 
+## 0.2.1 — 2026-09-01
+
+A manual **Sync** button that recalibrates this device's numbers on the dashboard.
+
+### Added
+
+- **Full sync.** The popover header gets a **⟳** button (also *Sync now* in the Account card and the tray
+  menu, and `codex-token-tracker sync` on the CLI). Unlike the background upload — which every 60 s pushes
+  only the hour buckets and sessions that changed — a full sync throws away every cache on the way:
+  1. re-reads the config, so agents enabled since start-up are picked up;
+  2. re-discovers every session directory and re-parses every transcript from scratch — Codex plus the
+     coding agents running on your Codex subscription (pi, OpenCode, Cline / Roo / Kilo, Hermes) and any
+     configured `extraSessionDirs` — instead of skipping files whose size and mtime are unchanged;
+  3. recomputes the aggregates with the current pricing table;
+  4. re-uploads **everything**, so the dashboard's totals for this device are replaced by the freshly
+     computed ones;
+  5. pulls the other devices' rows and the live rate limits back down.
+
+  Use it when a machine's numbers look wrong, after installing a new agent, or after an update that
+  changes the pricing table. It is manual only — never on a timer — because it re-sends the whole history.
+- A banner in the popover reports the phase while a sync runs (*Rescanning every agent's transcripts…*,
+  *Re-uploading this device's history…*) and then the result, e.g. `Synced codex, pi · 75 files ·
+  75 sessions · 70 hours re-uploaded`. Signed out, the rescan still runs and nothing leaves the machine.
+- `codex-token-tracker sync` prints the same summary and exits non-zero if the sync failed.
+
+- **Dev builds target the dev environment.** A build now carries its channel, stamped by
+  `scripts/build.mjs`: only `--release` (what `prepack` runs) produces a production build, so every
+  published tarball is prod and every local `pnpm build` / `pnpm dev` is dev. A dev build
+  - defaults to the local dashboard `http://localhost:3000` instead of `https://codex.chenli.dev`, and
+    therefore uploads to whatever Convex deployment that dashboard advertises — the dev one;
+  - keeps its config, device token and upload state in `~/.codex-tracker-dev`, so a local run can
+    never overwrite the production token or the record of what was already pushed to production;
+  - defaults `checkUpdates` to `false` and refuses `codex-token-tracker update`, which would otherwise
+    install the published package over the checkout;
+  - runs as `Codex Tracker (dev)` with its own Electron userData directory and macOS LaunchAgent, so it
+    can run **beside** an installed copy instead of fighting it for the single-instance lock;
+  - shows an orange **DEV** badge in the popover header and names its dashboard and config directory in
+    `--version`, `status` and `paths`.
+
+  `--dashboard <url>`, `config set dashboardUrl` and `CODEX_TRACKER_HOME` still override all of it.
+
+### Changed
+
+- `Uploader.pushAll()` takes a `{ full }` option that clears the pushed-buckets/pushed-sessions record
+  before building the payload, and waits for an in-flight incremental push instead of skipping the call.
+- `SessionStore.reset()` drops the parsed-file index so a following deep refresh re-reads everything.
+- Packaging scripts: `build:release` builds with the prod channel; `prepack` runs it (so `npm pack` and
+  `npm publish` always ship a prod build) and `postpack` restores the dev build in `dist/`.
+  `prepublishOnly` now only typechecks.
+- `app.setName()` moved ahead of `requestSingleInstanceLock()` — the lock is keyed on the userData
+  directory, which is derived from the name.
+
 ## 0.2.0 — 2026-09-01
 
 Pricing accuracy, an honest tokens/s number, and self-update.

package/README.md

@@ -61,6 +61,7 @@ The tracker discovers the Convex deployment through `<dashboard>/api/config`.
 | `codex-tracker login [--dashboard <url>]` | Device-code login |
 | `codex-tracker logout` | Forget the device token (local data stays) |
 | `codex-tracker status [--json]` | Today / 7d / 30d usage, live session, rate limits, models |
+| `codex-tracker sync` | Full sync: rescan every agent and re-upload this device's whole history |
 | `codex-tracker paths` | Detected Codex session directories |
 | `codex-tracker config get [key]` / `config set <key> <value>` | Settings (see below) |
 | `codex-tracker lang <en\|zh\|auto>` | Display language |
@@ -71,10 +72,35 @@ The tracker discovers the Convex deployment through `<dashboard>/api/config`.
 
 - Tray title shows today's tokens (`12.4k`) — `config set trayTitle tokens|cost|none`
 - Click: popover with Today, Live session (tokens/s, context window, rate limits), Activity heatmap, Models, Account
-- Right-click: Open dashboard, Sign in/out, Language, Launch at login, Refresh, Check for updates, Quit
+- Right-click: Open dashboard, Sign in/out, Language, Launch at login, Refresh, **Sync now**, Check for updates, Quit
 - A banner appears at the top of the popover when a newer version is published; **Update** installs it and the app asks you to restart
 - Launch at login uses a LaunchAgent on macOS and the registry run key on Windows
 
+## Sync
+
+The tracker uploads continuously in the background: every 60 s it sends the hour buckets and sessions
+that *changed* since the last push. **Sync** does the full version instead — use it when the dashboard's
+numbers for this machine look wrong, after you install a new agent, or after an update that changes the
+pricing table.
+
+Press the **⟳** button in the popover header (or *Sync now* in the Account card and the tray menu, or run
+`codex-tracker sync`). It:
+
+1. re-reads the config, so agents enabled since the app started are picked up;
+2. re-discovers **every** session directory and re-parses **every** transcript from scratch — Codex plus
+   the coding agents running on your Codex subscription (pi, OpenCode, Cline / Roo / Kilo, Hermes) and any
+   `extraSessionDirs` you configured — instead of skipping files whose size and mtime are unchanged;
+3. recomputes all aggregates with the current pricing table;
+4. re-uploads **everything**, not just what changed, so the dashboard's totals for this device are
+   replaced by the freshly computed ones — this is the calibration step;
+5. pulls the other devices' rows and the live rate limits back down.
+
+A banner reports the phase while it runs and then what it found (`Synced codex, pi · 75 files ·
+75 sessions · 70 hours re-uploaded`). Signed out, steps 1-3 still run and nothing leaves the machine.
+
+A full sync re-sends your whole history, so it costs more bandwidth than a normal push — it is a manual
+action, never on a timer.
+
 ## Windows and WSL2
 
 **Native Windows**: `npm i -g codex-token-tracker` in PowerShell, then `codex-tracker`. The tray app also scans every WSL distro (`\\wsl$\<distro>\home\*\.codex\sessions`) so sessions run inside WSL are counted.
@@ -199,7 +225,42 @@ CODEX_TRACKER_DEVTOOLS=1 ...                                                # op
 pnpm --filter codex-token-tracker build:icons                               # regenerate tray icons
 ```
 
-Publishing (from the repo root): `pnpm release:menubar` — `prepublishOnly` rebuilds and typechecks first.
+### Dev builds vs published builds
+
+A build knows which environment it belongs to, so a local test run can never write into production.
+`scripts/build.mjs` stamps the channel at bundle time: **only `--release` produces a prod build**, which
+is what `prepack` runs — so every tarball and every `npm publish` is prod, and every `pnpm build`,
+`pnpm dev` and watch-mode rebuild is dev.
+
+| | dev build (`pnpm build`) | published build (`npm i -g codex-token-tracker`) |
+| --- | --- | --- |
+| Dashboard default | `http://localhost:3000` | `https://codex.chenli.dev` |
+| Convex deployment | whatever the local dashboard's `/api/config` advertises — the **dev** one | production |
+| Config, device token, upload state | `~/.codex-tracker-dev` | `~/.codex-tracker` |
+| `checkUpdates` default | `false` (`update` refuses to run) | `true` |
+| App name / Electron userData | `Codex Tracker (dev)` | `Codex Tracker` |
+| macOS LaunchAgent | `dev.codex-tracker.menubar.dev` | `dev.codex-tracker.menubar` |
+| Popover | orange **DEV** badge in the header | — |
+
+Because the two differ in app name and config directory, **a dev build and an installed one can run at
+the same time**, each with its own tray icon, device token and upload state.
+
+To test against a dev environment, start the dashboard and Convex, then run the local build:
+
+```bash
+cd apps/dashboard && npx convex dev            # terminal 1
+pnpm dev                                        # terminal 2 — http://localhost:3000
+pnpm --filter codex-token-tracker build         # terminal 3
+node packages/menubar/bin/codex-tracker.js login   # → localhost:3000, no --dashboard needed
+node packages/menubar/bin/codex-tracker.js menubar
+```
+
+Both defaults are only *defaults*: `--dashboard <url>` and `config set dashboardUrl <url>` still point
+either build anywhere, and `CODEX_TRACKER_HOME` still overrides the config directory.
+
+Publishing (from the repo root): `pnpm release:menubar` — `prepublishOnly` typechecks and `prepack`
+makes the release build, so a published tarball is never accidentally a dev build. `postpack` restores
+the dev build in `dist/` afterwards, so your working copy keeps pointing at localhost.
 
 ## License
 

package/dist/cli.js

@@ -1138,9 +1138,20 @@ var init_src = __esm({
   }
 });
 
+// src/version.ts
+var APP_VERSION, APP_CHANNEL, IS_DEV_BUILD;
+var init_version = __esm({
+  "src/version.ts"() {
+    "use strict";
+    APP_VERSION = true ? "0.2.1" : "0.0.0-dev";
+    APP_CHANNEL = true ? "prod" : "dev";
+    IS_DEV_BUILD = APP_CHANNEL === "dev";
+  }
+});
+
 // src/core/config.ts
 function configDir() {
-  return process.env.CODEX_TRACKER_HOME || import_node_path2.default.join(import_node_os2.default.homedir(), ".codex-tracker");
+  return process.env.CODEX_TRACKER_HOME || import_node_path2.default.join(import_node_os2.default.homedir(), IS_DEV_BUILD ? ".codex-tracker-dev" : ".codex-tracker");
 }
 function readJson(file, fallback) {
   try {
@@ -1193,7 +1204,7 @@ function loadConfig() {
   cfg.sources = normalizeSources(stored.sources);
   cfg.trackAllProviders = stored.trackAllProviders === true;
   cfg.liveRateLimits = stored.liveRateLimits !== false;
-  cfg.checkUpdates = stored.checkUpdates !== false;
+  cfg.checkUpdates = typeof stored.checkUpdates === "boolean" ? stored.checkUpdates : DEFAULT_CONFIG.checkUpdates;
   if (!(cfg.usageRefreshSec >= 15)) cfg.usageRefreshSec = DEFAULT_CONFIG.usageRefreshSec;
   if (!["auto", "en", "zh"].includes(cfg.language)) cfg.language = "auto";
   if (!(cfg.uploadIntervalSec >= 10)) cfg.uploadIntervalSec = DEFAULT_CONFIG.uploadIntervalSec;
@@ -1300,14 +1311,17 @@ function loadPricingOverrides() {
   }
   return Object.keys(out).length ? out : void 0;
 }
-var import_node_fs2, import_node_os2, import_node_path2, DEFAULT_DASHBOARD_URL, SOURCE_FORMATS, DEFAULT_SOURCES, SOURCE_IDS, DEFAULT_CONFIG, EDITABLE_KEYS, AGENT_NAME_RE;
+var import_node_fs2, import_node_os2, import_node_path2, PROD_DASHBOARD_URL, DEV_DASHBOARD_URL, DEFAULT_DASHBOARD_URL, SOURCE_FORMATS, DEFAULT_SOURCES, SOURCE_IDS, DEFAULT_CONFIG, EDITABLE_KEYS, AGENT_NAME_RE;
 var init_config = __esm({
   "src/core/config.ts"() {
     "use strict";
     import_node_fs2 = __toESM(require("node:fs"));
     import_node_os2 = __toESM(require("node:os"));
     import_node_path2 = __toESM(require("node:path"));
-    DEFAULT_DASHBOARD_URL = "https://codex.chenli.dev";
+    init_version();
+    PROD_DASHBOARD_URL = "https://codex.chenli.dev";
+    DEV_DASHBOARD_URL = "http://localhost:3000";
+    DEFAULT_DASHBOARD_URL = IS_DEV_BUILD ? DEV_DASHBOARD_URL : PROD_DASHBOARD_URL;
     SOURCE_FORMATS = ["codex", "pi", "generic", "opencode", "cline"];
     DEFAULT_SOURCES = { codex: true, pi: true, hermes: true, opencode: true, cline: true, roo: true, kilo: true };
     SOURCE_IDS = Object.keys(DEFAULT_SOURCES);
@@ -1327,7 +1341,8 @@ var init_config = __esm({
       trackAllProviders: false,
       liveRateLimits: true,
       usageRefreshSec: 60,
-      checkUpdates: true
+      // a dev build must never offer to replace itself with the published package
+      checkUpdates: !IS_DEV_BUILD
     };
     EDITABLE_KEYS = [
       "dashboardUrl",
@@ -1397,6 +1412,7 @@ var init_en = __esm({
       estimatedPricingHint: "Pricing estimated: model not in the price table",
       other: "Other",
       lastUpload: "Last upload {time}",
+      lastSync: "Last full sync {time}",
       neverUploaded: "Not uploaded yet",
       uploadError: "Upload error: {message}",
       allDevicesToday: "All devices today",
@@ -1415,10 +1431,26 @@ var init_en = __esm({
       launchAtLogin: "Launch at login",
       refresh: "Refresh",
       quit: "Quit",
+      // full sync
+      syncNow: "Sync now",
+      syncing: "Syncing\u2026",
+      syncTitle: "Rescan every agent on this device and re-upload its full usage history",
+      syncScanning: "Rescanning every agent's transcripts\u2026",
+      syncComputing: "Recomputing token usage\u2026",
+      syncUploading: "Re-uploading this device's history\u2026",
+      syncDownloading: "Fetching other devices\u2026",
+      syncLimits: "Refreshing rate limits\u2026",
+      syncDone: "Synced {agents} \xB7 {files} files \xB7 {sessions} sessions \xB7 {buckets} hours re-uploaded",
+      syncDoneLocal: "Rescanned {agents} \xB7 {files} files \xB7 {sessions} sessions \u2014 sign in to upload",
+      syncFailed: "Sync failed: {message}",
       sessions: "{n} sessions",
       files: "{n} files",
       noData: "No usage found yet. Run Codex and this will fill in.",
       version: "v{version}",
+      // dev builds
+      devBuild: "DEV",
+      devBuildTitle: "Local build \u2014 uploading to {url} (dev environment). Config: {dir}",
+      devBuildMenu: "Dev build \u2192 {url}",
       justNow: "just now",
       never: "never",
       local: "Local",
@@ -1446,6 +1478,7 @@ Commands:
   login             Connect this device to your dashboard (--dashboard <url>)
   logout            Disconnect this device
   status            Print today's usage, live session and rate limits
+  sync              Rescan every agent and re-upload this device's full history (calibrate)
   paths             Show detected session directories (Codex, pi, OpenCode, Cline/Roo/Kilo, Hermes, custom)
   update            Install the newest published version (--check only reports)
   config get|set    Read or change settings (config set uploadIntervalSec 30, config set sources.pi false)
@@ -1500,7 +1533,15 @@ Options:
       cliUpdateRunning: "Running: {command}",
       cliUpdateDone: "Updated to {version}. Restart the menu bar app (or rerun the CLI) to use it.",
       cliUpdateFailed: "Update failed (exit {code}). Run it yourself: {command}",
-      cliUpdateCheckFailed: "Could not reach the npm registry: {message}"
+      cliUpdateCheckFailed: "Could not reach the npm registry: {message}",
+      cliSyncStart: "Full sync: rescanning every agent on this device\u2026",
+      cliSyncScanned: "  scanned {files} files in {roots} directories ({agents})",
+      cliSyncUploaded: "  re-uploaded {buckets} hour buckets and {sessions} sessions",
+      cliSyncLocal: "  not signed in \u2014 nothing uploaded (run `codex-tracker login` first)",
+      cliSyncDone: "Sync complete in {seconds}s \u2014 {sessions} sessions, today {tokens} tok \xB7 {cost}",
+      cliSyncFailed: "Sync failed: {message}",
+      cliChannelDev: "Dev build \u2014 dashboard {url} \xB7 config {dir}",
+      cliUpdateDevBuild: "This is a local dev build; `update` would install the published package over it. Run `pnpm build` in the repo instead."
     };
   }
 });
@@ -1554,6 +1595,7 @@ var init_zh = __esm({
       estimatedPricingHint: "\u4EF7\u683C\u4E3A\u4F30\u7B97\u503C\uFF1A\u8BE5\u6A21\u578B\u4E0D\u5728\u4EF7\u76EE\u8868\u4E2D",
       other: "\u5176\u4ED6",
       lastUpload: "\u4E0A\u6B21\u4E0A\u4F20 {time}",
+      lastSync: "\u4E0A\u6B21\u5B8C\u6574\u540C\u6B65 {time}",
       neverUploaded: "\u5C1A\u672A\u4E0A\u4F20",
       uploadError: "\u4E0A\u4F20\u5931\u8D25\uFF1A{message}",
       allDevicesToday: "\u6240\u6709\u8BBE\u5907\u4ECA\u65E5",
@@ -1572,10 +1614,26 @@ var init_zh = __esm({
       launchAtLogin: "\u5F00\u673A\u81EA\u542F\u52A8",
       refresh: "\u5237\u65B0",
       quit: "\u9000\u51FA",
+      // 完整同步
+      syncNow: "\u7ACB\u5373\u540C\u6B65",
+      syncing: "\u540C\u6B65\u4E2D\u2026",
+      syncTitle: "\u91CD\u65B0\u626B\u63CF\u672C\u8BBE\u5907\u4E0A\u7684\u6240\u6709\u667A\u80FD\u4F53\uFF0C\u5E76\u91CD\u65B0\u4E0A\u4F20\u5B8C\u6574\u7528\u91CF\u5386\u53F2",
+      syncScanning: "\u6B63\u5728\u91CD\u65B0\u626B\u63CF\u6240\u6709\u667A\u80FD\u4F53\u7684\u4F1A\u8BDD\u8BB0\u5F55\u2026",
+      syncComputing: "\u6B63\u5728\u91CD\u65B0\u8BA1\u7B97 token \u7528\u91CF\u2026",
+      syncUploading: "\u6B63\u5728\u91CD\u65B0\u4E0A\u4F20\u672C\u8BBE\u5907\u7684\u5386\u53F2\u6570\u636E\u2026",
+      syncDownloading: "\u6B63\u5728\u62C9\u53D6\u5176\u4ED6\u8BBE\u5907\u7684\u6570\u636E\u2026",
+      syncLimits: "\u6B63\u5728\u5237\u65B0\u9650\u989D\u2026",
+      syncDone: "\u5DF2\u540C\u6B65 {agents} \xB7 {files} \u4E2A\u6587\u4EF6 \xB7 {sessions} \u4E2A\u4F1A\u8BDD \xB7 \u91CD\u65B0\u4E0A\u4F20 {buckets} \u4E2A\u5C0F\u65F6\u6BB5",
+      syncDoneLocal: "\u5DF2\u91CD\u65B0\u626B\u63CF {agents} \xB7 {files} \u4E2A\u6587\u4EF6 \xB7 {sessions} \u4E2A\u4F1A\u8BDD \u2014 \u767B\u5F55\u540E\u53EF\u4E0A\u4F20",
+      syncFailed: "\u540C\u6B65\u5931\u8D25\uFF1A{message}",
       sessions: "{n} \u4E2A\u4F1A\u8BDD",
       files: "{n} \u4E2A\u6587\u4EF6",
       noData: "\u8FD8\u6CA1\u6709\u7528\u91CF\u6570\u636E\u3002\u8FD0\u884C Codex \u540E\u8FD9\u91CC\u4F1A\u81EA\u52A8\u66F4\u65B0\u3002",
       version: "v{version}",
+      // 开发版
+      devBuild: "\u5F00\u53D1\u7248",
+      devBuildTitle: "\u672C\u5730\u6784\u5EFA \u2014\u2014 \u6570\u636E\u4E0A\u4F20\u81F3 {url}\uFF08\u5F00\u53D1\u73AF\u5883\uFF09\u3002\u914D\u7F6E\u76EE\u5F55\uFF1A{dir}",
+      devBuildMenu: "\u5F00\u53D1\u7248 \u2192 {url}",
       justNow: "\u521A\u521A",
       never: "\u4ECE\u672A",
       local: "\u672C\u673A",
@@ -1601,6 +1659,7 @@ var init_zh = __esm({
   login             \u5C06\u672C\u8BBE\u5907\u8FDE\u63A5\u5230\u4EEA\u8868\u76D8\uFF08--dashboard <url>\uFF09
   logout            \u65AD\u5F00\u672C\u8BBE\u5907
   status            \u6253\u5370\u4ECA\u65E5\u7528\u91CF\u3001\u5B9E\u65F6\u4F1A\u8BDD\u4E0E\u9650\u989D
+  sync              \u91CD\u65B0\u626B\u63CF\u6240\u6709\u667A\u80FD\u4F53\u5E76\u91CD\u65B0\u4E0A\u4F20\u672C\u8BBE\u5907\u5B8C\u6574\u5386\u53F2\uFF08\u6821\u51C6\uFF09
   paths             \u663E\u793A\u68C0\u6D4B\u5230\u7684\u4F1A\u8BDD\u76EE\u5F55\uFF08Codex\u3001pi\u3001OpenCode\u3001Cline/Roo/Kilo\u3001Hermes\u3001\u81EA\u5B9A\u4E49\uFF09
   update            \u5B89\u88C5\u6700\u65B0\u53D1\u5E03\u7248\u672C\uFF08--check \u53EA\u68C0\u67E5\u4E0D\u5B89\u88C5\uFF09
   config get|set    \u8BFB\u53D6\u6216\u4FEE\u6539\u8BBE\u7F6E\uFF08config set uploadIntervalSec 30\uFF0Cconfig set sources.pi false\uFF09
@@ -1655,7 +1714,15 @@ var init_zh = __esm({
       cliUpdateRunning: "\u6B63\u5728\u6267\u884C\uFF1A{command}",
       cliUpdateDone: "\u5DF2\u66F4\u65B0\u5230 {version}\u3002\u8BF7\u91CD\u542F\u83DC\u5355\u680F\u5E94\u7528\uFF08\u6216\u91CD\u65B0\u8FD0\u884C CLI\uFF09\u4EE5\u751F\u6548\u3002",
       cliUpdateFailed: "\u66F4\u65B0\u5931\u8D25\uFF08\u9000\u51FA\u7801 {code}\uFF09\u3002\u8BF7\u624B\u52A8\u6267\u884C\uFF1A{command}",
-      cliUpdateCheckFailed: "\u65E0\u6CD5\u8BBF\u95EE npm registry\uFF1A{message}"
+      cliUpdateCheckFailed: "\u65E0\u6CD5\u8BBF\u95EE npm registry\uFF1A{message}",
+      cliSyncStart: "\u5B8C\u6574\u540C\u6B65\uFF1A\u6B63\u5728\u91CD\u65B0\u626B\u63CF\u672C\u8BBE\u5907\u4E0A\u7684\u6240\u6709\u667A\u80FD\u4F53\u2026",
+      cliSyncScanned: "  \u5DF2\u626B\u63CF {roots} \u4E2A\u76EE\u5F55\u4E2D\u7684 {files} \u4E2A\u6587\u4EF6\uFF08{agents}\uFF09",
+      cliSyncUploaded: "  \u5DF2\u91CD\u65B0\u4E0A\u4F20 {buckets} \u4E2A\u5C0F\u65F6\u6BB5\u4E0E {sessions} \u4E2A\u4F1A\u8BDD",
+      cliSyncLocal: "  \u672A\u767B\u5F55 \u2014 \u6CA1\u6709\u4E0A\u4F20\u4EFB\u4F55\u6570\u636E\uFF08\u8BF7\u5148\u8FD0\u884C `codex-tracker login`\uFF09",
+      cliSyncDone: "\u540C\u6B65\u5B8C\u6210\uFF0C\u7528\u65F6 {seconds} \u79D2 \u2014 {sessions} \u4E2A\u4F1A\u8BDD\uFF0C\u4ECA\u65E5 {tokens} tok \xB7 {cost}",
+      cliSyncFailed: "\u540C\u6B65\u5931\u8D25\uFF1A{message}",
+      cliChannelDev: "\u5F00\u53D1\u7248 \u2014\u2014 \u4EEA\u8868\u76D8 {url} \xB7 \u914D\u7F6E\u76EE\u5F55 {dir}",
+      cliUpdateDevBuild: "\u8FD9\u662F\u672C\u5730\u5F00\u53D1\u7248\uFF1B`update` \u4F1A\u7528\u5DF2\u53D1\u5E03\u7684\u5305\u8986\u76D6\u5B83\u3002\u8BF7\u6539\u4E3A\u5728\u4ED3\u5E93\u4E2D\u8FD0\u884C `pnpm build`\u3002"
     };
   }
 });
@@ -8630,11 +8697,25 @@ var init_uploader = __esm({
           throw err;
         }
       }
-      /** Upload changed hour buckets and session summaries. Returns counts of pushed items. */
-      async pushAll(buckets, sessions, sessionCosts) {
+      /** Wait for an in-flight incremental push to finish so a full sync isn't skipped by the guard. */
+      async awaitIdle(timeoutMs = 15e3) {
+        const deadline = Date.now() + timeoutMs;
+        while (this.inFlight && Date.now() < deadline) await new Promise((r) => setTimeout(r, 100));
+      }
+      /**
+       * Upload changed hour buckets and session summaries. Returns counts of pushed items.
+       * With `full`, the record of what was already pushed is dropped first so *everything* is re-sent —
+       * that is what recalibrates this device's totals on the dashboard after a parser or pricing change.
+       */
+      async pushAll(buckets, sessions, sessionCosts, opts = {}) {
+        if (opts.full) await this.awaitIdle();
         if (this.inFlight) return { buckets: 0, sessions: 0 };
         this.inFlight = true;
         try {
+          if (opts.full) {
+            this.state.pushedBuckets = {};
+            this.state.pushedSessions = {};
+          }
           const changed = [];
           const hashes = /* @__PURE__ */ new Map();
           for (const b of buckets.sort((a, b2) => a.hourStart - b2.hourStart)) {
@@ -9708,6 +9789,15 @@ var SessionStore = class {
   onChange = null;
   debounceTimer = null;
   sessionCache = null;
+  /**
+   * Forget the parsed-file index so the next deep refresh re-reads and re-parses every transcript.
+   * Used by the full sync: files are otherwise skipped while their size and mtime are unchanged, which
+   * would keep stale numbers around after a parser or pricing change.
+   */
+  reset() {
+    this.files.clear();
+    this.sessionCache = null;
+  }
   async refreshDeep() {
     const o = this.getOptions();
     this.roots = discoverSessionRoots({ extraSessionDirs: o.extraSessionDirs, sources: o.sources });
@@ -10107,11 +10197,7 @@ var import_node_fs9 = __toESM(require("node:fs"));
 var import_node_path11 = __toESM(require("node:path"));
 var import_node_child_process4 = require("node:child_process");
 init_config();
-
-// src/version.ts
-var APP_VERSION = true ? "0.2.0" : "0.0.0-dev";
-
-// src/core/update.ts
+init_version();
 var NPM_PACKAGE = "codex-token-tracker";
 var CHECK_TTL_MS = 6 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 8e3;
@@ -10135,7 +10221,7 @@ function compareVersions(a, b) {
   return A.pre < B.pre ? -1 : 1;
 }
 function isDevBuild(version2) {
-  return version2.startsWith("0.0.0");
+  return IS_DEV_BUILD || version2.startsWith("0.0.0");
 }
 function registryBase() {
   const r = process.env.CODEX_TRACKER_REGISTRY || process.env.npm_config_registry || process.env.NPM_CONFIG_REGISTRY || "https://registry.npmjs.org";
@@ -10271,6 +10357,7 @@ function runUpdate(opts = {}) {
 }
 
 // src/core/engine.ts
+init_version();
 var SHALLOW_MS = 3e3;
 var DEEP_MS = 6e4;
 var TICK_MS = 2e3;
@@ -10278,6 +10365,7 @@ var REMOTE_MS = 6e4;
 var LIVE_LIMITS_DEBOUNCE_MS = 1e4;
 var LIVE_LIMITS_MIN_GAP_MS = 2e4;
 var UPDATE_CHECK_MS = 6 * 60 * 60 * 1e3;
+var SYNC_BANNER_MS = 25e3;
 var Engine = class extends import_node_events.EventEmitter {
   constructor(opts) {
     super();
@@ -10317,6 +10405,13 @@ var Engine = class extends import_node_events.EventEmitter {
   update = null;
   updateStatus = "idle";
   updateLog = null;
+  syncStatus = "idle";
+  syncPhase = null;
+  syncStartedAt = null;
+  syncFinishedAt = null;
+  syncError = null;
+  syncResult = null;
+  syncBannerTimer = null;
   get heatmapWeeks() {
     return this.opts.heatmapWeeks ?? 16;
   }
@@ -10367,6 +10462,8 @@ var Engine = class extends import_node_events.EventEmitter {
     this.timers = [];
     if (this.liveLimitsTimer) clearTimeout(this.liveLimitsTimer);
     this.liveLimitsTimer = null;
+    if (this.syncBannerTimer) clearTimeout(this.syncBannerTimer);
+    this.syncBannerTimer = null;
     this.store.stopWatching();
     this.pending?.abort.abort();
   }
@@ -10470,6 +10567,112 @@ var Engine = class extends import_node_events.EventEmitter {
     await this.uploader.fetchRemote(this.heatmapWeeks);
     this.recompute();
   }
+  /**
+   * Full sync ("calibrate this device"). Unlike the periodic incremental upload this deliberately
+   * throws away every cache on the way:
+   *  1. re-read the config so sources enabled since start-up are picked up,
+   *  2. drop the parsed-file index and re-discover + re-parse every transcript of every agent
+   *     (Codex plus the agents running on the Codex subscription: pi, OpenCode, Cline/Roo/Kilo,
+   *     Hermes and any custom `extraSessionDirs`),
+   *  3. recompute the aggregates with the current pricing table,
+   *  4. re-upload *everything* — not just what changed — so the dashboard's totals for this device
+   *     are replaced by the freshly computed ones,
+   *  5. pull the other devices' rows and the live rate limits back down.
+   *
+   * Returns null when a sync is already running. Never throws: failures land in the returned state.
+   */
+  async syncNow() {
+    if (this.syncStatus === "running") return null;
+    if (this.syncBannerTimer) {
+      clearTimeout(this.syncBannerTimer);
+      this.syncBannerTimer = null;
+    }
+    const startedAt = Date.now();
+    this.syncStatus = "running";
+    this.syncPhase = null;
+    this.syncStartedAt = startedAt;
+    this.syncFinishedAt = null;
+    this.syncError = null;
+    const phase = (p) => {
+      this.syncPhase = p;
+      this.emitSnapshot();
+    };
+    try {
+      phase("scanning");
+      this.reloadConfig();
+      this.store.reset();
+      await this.store.refreshDeep();
+      phase("computing");
+      this.recompute();
+      let uploadedBuckets = 0;
+      let uploadedSessions = 0;
+      const uploaded = this.opts.upload && this.signedIn;
+      if (uploaded) {
+        phase("uploading");
+        const r = await this.uploader.pushAll(this.stats.buckets, this.stats.sessions, this.stats.sessionCosts, { full: true });
+        uploadedBuckets = r.buckets;
+        uploadedSessions = r.sessions;
+        await this.heartbeatNow().catch(() => {
+        });
+        phase("downloading");
+        await this.fetchRemoteNow();
+      }
+      phase("limits");
+      await this.refreshLiveLimits(true);
+      const finishedAt = Date.now();
+      this.syncResult = {
+        startedAt,
+        finishedAt,
+        durationMs: finishedAt - startedAt,
+        files: this.store.fileCount,
+        sessions: this.store.sessions().length,
+        roots: this.store.roots.length,
+        agents: [...new Set(this.store.roots.map((r) => r.agent))].sort(),
+        uploadedBuckets,
+        uploadedSessions,
+        uploaded
+      };
+      this.syncStatus = "done";
+      this.syncFinishedAt = finishedAt;
+      this.opts.log?.(
+        `sync: ${this.syncResult.files} files, ${this.syncResult.sessions} sessions, ${uploadedBuckets} buckets / ${uploadedSessions} sessions uploaded in ${this.syncResult.durationMs} ms`
+      );
+      return this.syncResult;
+    } catch (err) {
+      this.syncStatus = "error";
+      this.syncFinishedAt = Date.now();
+      this.syncError = err instanceof SignedOutError ? "not signed in" : errorMessage(err);
+      this.opts.log?.(`sync failed: ${this.syncError}`);
+      return null;
+    } finally {
+      this.syncPhase = null;
+      this.emitSnapshot();
+      this.scheduleSyncBannerClear();
+    }
+  }
+  /** Return the sync banner to "idle" a little after it finished, keeping `last` for the footer. */
+  scheduleSyncBannerClear() {
+    if (this.opts.watch === false) return;
+    if (this.syncBannerTimer) clearTimeout(this.syncBannerTimer);
+    this.syncBannerTimer = setTimeout(() => {
+      this.syncBannerTimer = null;
+      if (this.syncStatus === "done" || this.syncStatus === "error") {
+        this.syncStatus = "idle";
+        this.emitSnapshot();
+      }
+    }, SYNC_BANNER_MS);
+    this.syncBannerTimer.unref?.();
+  }
+  syncState() {
+    return {
+      status: this.syncStatus,
+      phase: this.syncPhase,
+      startedAt: this.syncStartedAt,
+      finishedAt: this.syncFinishedAt,
+      error: this.syncError,
+      last: this.syncResult
+    };
+  }
   /**
    * Ask the npm registry for the newest published version (cached for 6 h unless `force`).
    * Best-effort: a failure is recorded on the snapshot, never thrown.
@@ -10587,6 +10790,7 @@ ${r.output}`.trim();
     const sessions = this.store.sessions();
     return {
       version: APP_VERSION,
+      channel: APP_CHANNEL,
       generatedAt: Date.now(),
       language: this.language(),
       languageSetting: this.config.language,
@@ -10605,6 +10809,7 @@ ${r.output}`.trim();
       rateLimitsError: this.config.liveRateLimits ? this.liveLimitsError : null,
       rateLimitsUpdatedAt: this.liveLimits ? this.liveLimitsAt : s.logRateLimits?.observedAt ?? null,
       update: this.updateState(),
+      sync: this.syncState(),
       modelsToday: s.modelsToday,
       modelsMonth: s.modelsMonth,
       byAgentToday: s.byAgentToday,
@@ -10621,6 +10826,7 @@ ${r.output}`.trim();
       },
       sessionDirs: SessionStore.rootDirs(this.store.roots),
       sessionRoots: this.store.roots.map((r) => ({ dir: r.dir, agent: r.agent, format: r.format, origin: r.origin })),
+      configDir: configDir(),
       launchAtLogin: this.config.launchAtLogin,
       trayTitle: this.config.trayTitle
     };
@@ -10632,6 +10838,7 @@ init_platform();
 init_config();
 init_uploader();
 init_i18n();
+init_version();
 function parseArgs2(argv) {
   const out = { command: null, positional: [], flags: {} };
   for (let i2 = 0; i2 < argv.length; i2++) {
@@ -10797,6 +11004,7 @@ async function runStatus(json) {
     s.auth.status === "signedIn" ? `${t2("signedInAs", { name: s.auth.user?.name || s.auth.user?.email || "?" })} \xB7 ${s.auth.dashboardUrl}` : t2("cliNotSignedIn")
   );
   line(t2("cliStatusDirs"), s.sessionDirs.join("\n" + " ".repeat(15)) || "-");
+  if (IS_DEV_BUILD) console.log(t2("cliChannelDev", { url: s.auth.dashboardUrl, dir: configDir() }));
   const byAgent = Object.entries(s.counts.byAgent).sort((a, b) => b[1].sessions - a[1].sessions).map(([agent, c]) => `${agent} ${c.sessions}`).join(", ");
   console.log(t2("sessions", { n: s.counts.sessions }) + " \xB7 " + t2("files", { n: s.counts.files }) + (byAgent ? ` (${byAgent})` : ""));
   if (cfg.checkUpdates) {
@@ -10805,6 +11013,36 @@ async function runStatus(json) {
   }
   return 0;
 }
+async function runSync(flags) {
+  const cfg = applyDashboardFlag(flags);
+  const L = lang(cfg);
+  const t2 = makeT(L);
+  const engine = new Engine({
+    upload: true,
+    watch: false,
+    systemLocale: systemLocale(),
+    log: process.env.CODEX_TRACKER_DEBUG ? (m) => console.error("[sync]", m) : void 0
+  });
+  console.log(t2("cliSyncStart"));
+  const result = await engine.syncNow();
+  if (!result) {
+    console.error(t2("cliSyncFailed", { message: engine.snapshot().sync.error ?? "?" }));
+    return 1;
+  }
+  console.log(t2("cliSyncScanned", { files: result.files, roots: result.roots, agents: result.agents.join(", ") || "-" }));
+  if (result.uploaded) console.log(t2("cliSyncUploaded", { buckets: result.uploadedBuckets, sessions: result.uploadedSessions }));
+  else console.log(t2("cliSyncLocal"));
+  const s = engine.snapshot();
+  console.log(
+    t2("cliSyncDone", {
+      seconds: (result.durationMs / 1e3).toFixed(1),
+      sessions: result.sessions,
+      tokens: formatTokens(s.today.usage.total),
+      cost: formatUSD(s.today.cost)
+    })
+  );
+  return 0;
+}
 async function runLogin(flags) {
   const cfg = applyDashboardFlag(flags);
   const L = lang(cfg);
@@ -10908,6 +11146,7 @@ function runPaths() {
   const off = SOURCE_IDS.filter((id) => !cfg.sources[id]);
   if (off.length) console.log(`  (disabled: ${off.join(", ")})`);
   console.log(t2("cliConfigDir", { dir: configDir() }));
+  if (IS_DEV_BUILD) console.log(t2("cliChannelDev", { url: cfg.dashboardUrl, dir: configDir() }));
   return 0;
 }
 function runConfig(positional) {
@@ -10954,6 +11193,10 @@ function runConfig(positional) {
 }
 async function runUpdateCommand(flags) {
   const t2 = makeT(lang());
+  if (IS_DEV_BUILD) {
+    console.error(t2("cliUpdateDevBuild"));
+    return 1;
+  }
   const info2 = await checkForUpdate({ force: true });
   if (info2.error && !info2.latest) {
     console.error(t2("cliUpdateCheckFailed", { message: info2.error }));
@@ -10992,6 +11235,7 @@ async function main() {
   const t2 = makeT(lang());
   if (args.flags.version) {
     console.log(t2("cliVersion", { version: APP_VERSION }));
+    if (IS_DEV_BUILD) console.log(t2("cliChannelDev", { url: loadConfig().dashboardUrl, dir: configDir() }));
     return 0;
   }
   if (args.flags.help || args.command === "help") {
@@ -11028,6 +11272,8 @@ async function main() {
     }
     case "status":
       return runStatus(args.flags.json === true);
+    case "sync":
+      return runSync(args.flags);
     case "paths":
       return runPaths();
     case "config":