sidekick-agent-hub 0.18.1 → 0.18.2

package/README.md

@@ -114,7 +114,7 @@ sidekick quota
 Provider-aware quota and rate-limit display. The command auto-detects the active provider:
 
 - **Claude Code**: Shows Claude Max subscription quota — 5-hour and 7-day windows with color-coded progress bars, projections, and reset countdowns. Includes a peak-hours summary line.
-- **Codex**: Shows rate limits from the latest session's event stream — primary and secondary windows with progress bars and reset countdowns.
+- **Codex**: Shows rate limits from Codex `token_count.rate_limits` events — primary and secondary windows with progress bars and reset countdowns. The default path is local-only: current workspace rollout, recent account-level rollouts, then the active account's cached snapshot. Add `--refresh` to explicitly refresh from Codex's usage API before falling back to local data.
 - **OpenCode**: Prints an informational message (no rate-limit data available).
 
 ```
@@ -126,7 +126,7 @@ Subscription Quota
 
 When quota data is unavailable, `sidekick quota` shows structured auth, rate-limit, network, server, or unexpected-failure messaging instead of a generic raw error. The dashboard Sessions panel also keeps a compact inline quota/rate-limit state visible instead of hiding the section entirely.
 
-Use `--json` for machine-readable output. Use `--provider codex` to explicitly check Codex rate limits. Claude Code requires active credentials (read from the system Keychain on macOS, or `~/.claude/.credentials.json` on Linux/Windows). JSON output includes `failureKind`, `httpStatus`, and `retryAfterMs` on unavailable responses.
+Use `--json` for machine-readable output. Use `--provider codex` to explicitly check Codex rate limits, and `--refresh` to opt in to a Codex usage API refresh. Claude Code requires active credentials (read from the system Keychain on macOS, or `~/.claude/.credentials.json` on Linux/Windows). JSON output includes `failureKind`, `httpStatus`, and `retryAfterMs` on unavailable responses.
 
 When multi-account is enabled, `sidekick quota` shows the active account email above the quota bars.
 

package/dist/sidekick-cli.mjs

@@ -4865,6 +4865,31 @@ var require_detect = __commonJS({
     function getCodexHomes() {
       return (0, codexProfiles_1.getCodexMonitoringHomes)();
     }
+    function hasCodexStateDb(codexHome) {
+      try {
+        return fs9.readdirSync(codexHome).some((entry) => /^state(?:_\d+)?\.sqlite$/.test(entry));
+      } catch {
+        return false;
+      }
+    }
+    function getCodexStateDbMtime(codexHome) {
+      try {
+        let latest = 0;
+        for (const entry of fs9.readdirSync(codexHome)) {
+          if (!/^state(?:_\d+)?\.sqlite$/.test(entry))
+            continue;
+          try {
+            const mtime = fs9.statSync(path8.join(codexHome, entry)).mtime.getTime();
+            if (mtime > latest)
+              latest = mtime;
+          } catch {
+          }
+        }
+        return latest;
+      } catch {
+        return 0;
+      }
+    }
     function getMostRecentMtime(dir) {
       try {
         if (!fs9.existsSync(dir))
@@ -4903,13 +4928,9 @@ var require_detect = __commonJS({
     function getCodexActivityMtime() {
       let latest = 0;
       for (const codexHome of getCodexHomes()) {
-        const dbPath = path8.join(codexHome, "state.sqlite");
-        try {
-          const dbMtime = fs9.statSync(dbPath).mtime.getTime();
-          if (dbMtime > latest)
-            latest = dbMtime;
-        } catch {
-        }
+        const dbMtime = getCodexStateDbMtime(codexHome);
+        if (dbMtime > latest)
+          latest = dbMtime;
         const sessionsMtime = getMostRecentMtime(path8.join(codexHome, "sessions"));
         if (sessionsMtime > latest)
           latest = sessionsMtime;
@@ -4931,7 +4952,7 @@ var require_detect = __commonJS({
       const { claudeBase, openCodeDbPath, openCodeStorageDir, codexHomes } = getProviderPaths();
       const hasClaude = fs9.existsSync(claudeBase);
       const hasOpenCode = fs9.existsSync(openCodeStorageDir) || fs9.existsSync(openCodeDbPath);
-      const hasCodex = codexHomes.some((codexHome) => fs9.existsSync(path8.join(codexHome, "sessions")) || fs9.existsSync(path8.join(codexHome, "state.sqlite")));
+      const hasCodex = codexHomes.some((codexHome) => fs9.existsSync(path8.join(codexHome, "sessions")) || hasCodexStateDb(codexHome));
       const available = [];
       if (hasClaude)
         available.push({ id: "claude-code", mtime: getMostRecentMtime(claudeBase) });
@@ -4948,7 +4969,7 @@ var require_detect = __commonJS({
       const { claudeBase, openCodeDbPath, openCodeStorageDir, codexHomes } = getProviderPaths();
       const hasClaude = fs9.existsSync(claudeBase);
       const hasOpenCode = fs9.existsSync(openCodeStorageDir) || fs9.existsSync(openCodeDbPath);
-      const hasCodex = codexHomes.some((codexHome) => fs9.existsSync(path8.join(codexHome, "sessions")) || fs9.existsSync(path8.join(codexHome, "state.sqlite")));
+      const hasCodex = codexHomes.some((codexHome) => fs9.existsSync(path8.join(codexHome, "sessions")) || hasCodexStateDb(codexHome));
       const available = [];
       if (hasClaude) {
         available.push({ id: "claude-code", mtime: getMostRecentMtime(claudeBase) });
@@ -8984,7 +9005,7 @@ var require_codexDatabase = __commonJS({
       dbPath;
       sqlite3Available = null;
       constructor(codexHome) {
-        this.dbPath = path8.join(codexHome, "state.sqlite");
+        this.dbPath = findLatestStateDatabase(codexHome) ?? path8.join(codexHome, "state.sqlite");
       }
       isAvailable() {
         try {
@@ -9075,6 +9096,28 @@ var require_codexDatabase = __commonJS({
       }
     };
     exports.CodexDatabase = CodexDatabase;
+    function findLatestStateDatabase(codexHome) {
+      try {
+        const entries = fs9.readdirSync(codexHome, { withFileTypes: true });
+        const candidates = [];
+        for (const entry of entries) {
+          if (!entry.isFile() || !/^state(?:_\d+)?\.sqlite$/.test(entry.name))
+            continue;
+          const dbPath = path8.join(codexHome, entry.name);
+          try {
+            const stat = fs9.statSync(dbPath);
+            if (stat.size > 0) {
+              candidates.push({ path: dbPath, mtime: stat.mtime.getTime() });
+            }
+          } catch {
+          }
+        }
+        candidates.sort((a, b) => b.mtime - a.mtime);
+        return candidates[0]?.path ?? null;
+      } catch {
+        return null;
+      }
+    }
     function normalizePath(input) {
       try {
         return fs9.realpathSync(input);
@@ -11668,15 +11711,15 @@ var require_jsonlWatcher = __commonJS({
           if (evtType === "token_count") {
             const info = payload?.info;
             const usage = info?.last_token_usage || info?.total_token_usage;
-            if (usage) {
-              const rl = payload?.rate_limits;
-              const rateLimits = rl ? extractRateLimits(rl) : void 0;
+            const rl = payload?.rate_limits;
+            const rateLimits = rl ? extractRateLimits(rl) : void 0;
+            if (usage || rateLimits) {
               events.push({
                 providerId: "codex",
                 type: "system",
                 timestamp: ts,
-                summary: `Tokens: ${usage.input_tokens ?? 0} in / ${usage.output_tokens ?? 0} out`,
-                tokens: { input: usage.input_tokens || 0, output: usage.output_tokens || 0 },
+                summary: usage ? `Tokens: ${usage.input_tokens ?? 0} in / ${usage.output_tokens ?? 0} out` : "Rate limits updated",
+                tokens: usage ? { input: usage.input_tokens || 0, output: usage.output_tokens || 0 } : void 0,
                 rateLimits,
                 raw
               });
@@ -12056,7 +12099,7 @@ var require_factory = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.createWatcher = createWatcher5;
+    exports.createWatcher = createWatcher4;
     var os6 = __importStar(__require("os"));
     var path8 = __importStar(__require("path"));
     var jsonlWatcher_1 = require_jsonlWatcher();
@@ -12067,7 +12110,7 @@ var require_factory = __commonJS({
         return path8.join(xdg, "opencode");
       return path8.join(os6.homedir(), ".local", "share", "opencode");
     }
-    function createWatcher5(options) {
+    function createWatcher4(options) {
       const { provider, workspacePath, sessionId, callbacks } = options;
       const sessions = provider.findAllSessions(workspacePath);
       if (sessions.length === 0) {
@@ -18839,8 +18882,8 @@ var require_quotaSnapshots = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.writeQuotaSnapshot = writeQuotaSnapshot2;
-    exports.readQuotaSnapshot = readQuotaSnapshot2;
+    exports.writeQuotaSnapshot = writeQuotaSnapshot;
+    exports.readQuotaSnapshot = readQuotaSnapshot;
     var crypto = __importStar(__require("crypto"));
     var fs9 = __importStar(__require("fs"));
     var path8 = __importStar(__require("path"));
@@ -18883,7 +18926,7 @@ var require_quotaSnapshots = __commonJS({
       ensureConfigDir();
       atomicWriteJson(getQuotaSnapshotPath(), store);
     }
-    function writeQuotaSnapshot2(providerId, accountId, quota) {
+    function writeQuotaSnapshot(providerId, accountId, quota) {
       const store = readStore();
       const snapshot = {
         ...quota,
@@ -18905,7 +18948,7 @@ var require_quotaSnapshots = __commonJS({
       }
       writeStore(store);
     }
-    function readQuotaSnapshot2(providerId, accountId) {
+    function readQuotaSnapshot(providerId, accountId) {
       const store = readStore();
       const snapshot = store.snapshots.find((item) => item.providerId === providerId && item.accountId === accountId);
       if (!snapshot)
@@ -18924,24 +18967,413 @@ var require_quotaSnapshots = __commonJS({
 var require_codexQuota = __commonJS({
   "../sidekick-shared/dist/codexQuota.js"(exports) {
     "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    } : function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    });
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
+      Object.defineProperty(o, "default", { enumerable: true, value: v });
+    } : function(o, v) {
+      o["default"] = v;
+    });
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
+      var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function(o2) {
+          var ar = [];
+          for (var k in o2) if (Object.prototype.hasOwnProperty.call(o2, k)) ar[ar.length] = k;
+          return ar;
+        };
+        return ownKeys(o);
+      };
+      return function(mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) {
+          for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        }
+        __setModuleDefault(result, mod);
+        return result;
+      };
+    }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.quotaFromCodexRateLimits = quotaFromCodexRateLimits3;
-    function quotaFromCodexRateLimits3(rateLimits, source = "session", capturedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+    exports.quotaFromCodexRateLimits = quotaFromCodexRateLimits2;
+    exports.readLatestCodexQuotaFromRollouts = readLatestCodexQuotaFromRollouts;
+    exports.resolveCodexQuotaFromLocalSources = resolveCodexQuotaFromLocalSources;
+    exports.resolveCodexQuota = resolveCodexQuota2;
+    exports.fetchCodexQuotaFromApi = fetchCodexQuotaFromApi;
+    var fs9 = __importStar(__require("fs"));
+    var path8 = __importStar(__require("path"));
+    var codexProfiles_1 = require_codexProfiles();
+    var quotaSnapshots_1 = require_quotaSnapshots();
+    var codex_1 = require_codex();
+    var DEFAULT_TAIL_BYTES = 2 * 1024 * 1024;
+    var DEFAULT_MAX_SESSION_FILES = 50;
+    var CHATGPT_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
+    function normalizePercent(value) {
+      return typeof value === "number" && Number.isFinite(value) ? value : 0;
+    }
+    function timestampToIso(seconds) {
+      if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds <= 0) {
+        return "";
+      }
+      return new Date(seconds * 1e3).toISOString();
+    }
+    function accountEmail(account) {
+      return account?.email ?? account?.metadata?.email;
+    }
+    function enrichCodexQuota(state, account) {
+      return {
+        ...state,
+        runtimeProvider: "codex",
+        providerId: "codex",
+        accountLabel: account?.label,
+        accountDetail: accountEmail(account)
+      };
+    }
+    function unavailableCodexQuota(error, account, meta = {}) {
+      return enrichCodexQuota({
+        fiveHour: { utilization: 0, resetsAt: "" },
+        sevenDay: { utilization: 0, resetsAt: "" },
+        available: false,
+        error,
+        providerId: "codex",
+        fiveHourLabel: "Primary",
+        sevenDayLabel: "Secondary",
+        ...meta
+      }, account);
+    }
+    function parseRetryAfterMs(retryAfter) {
+      if (!retryAfter)
+        return void 0;
+      const seconds = Number(retryAfter);
+      if (Number.isFinite(seconds) && seconds >= 0) {
+        return Math.round(seconds * 1e3);
+      }
+      const retryAt = Date.parse(retryAfter);
+      if (Number.isNaN(retryAt))
+        return void 0;
+      return Math.max(retryAt - Date.now(), 0);
+    }
+    function firstString(value) {
+      return typeof value === "string" && value.trim() ? value : void 0;
+    }
+    function normalizeCredits(credits) {
+      if (!credits)
+        return void 0;
+      return {
+        hasCredits: credits.has_credits ?? credits.hasCredits,
+        unlimited: credits.unlimited,
+        balance: credits.balance ?? void 0
+      };
+    }
+    function normalizeRateLimitReachedType(value) {
+      if (typeof value === "string")
+        return value;
+      return firstString(value?.kind);
+    }
+    function normalizeApiWindow(window2) {
+      if (!window2)
+        return void 0;
+      const windowMinutes = typeof window2.window_minutes === "number" || window2.window_minutes === null ? window2.window_minutes : typeof window2.limit_window_seconds === "number" ? Math.round(window2.limit_window_seconds / 60) : void 0;
+      const resetsAt = typeof window2.resets_at === "number" || window2.resets_at === null ? window2.resets_at : window2.reset_at;
+      return {
+        used_percent: normalizePercent(window2.used_percent),
+        window_minutes: windowMinutes,
+        resets_at: resetsAt
+      };
+    }
+    function rateLimitsFromUsagePayload(payload) {
+      if (payload.primary || payload.secondary) {
+        return {
+          limit_id: payload.limit_id ?? "codex",
+          limit_name: payload.limit_name ?? null,
+          primary: payload.primary,
+          secondary: payload.secondary,
+          credits: normalizeCredits(payload.credits),
+          plan_type: payload.plan_type ?? void 0,
+          rate_limit_reached_type: normalizeRateLimitReachedType(payload.rate_limit_reached_type)
+        };
+      }
+      const preferred = payload.rate_limit;
+      return {
+        limit_id: "codex",
+        limit_name: null,
+        primary: normalizeApiWindow(preferred?.primary_window),
+        secondary: normalizeApiWindow(preferred?.secondary_window),
+        credits: normalizeCredits(payload.credits),
+        plan_type: payload.plan_type ?? void 0,
+        rate_limit_reached_type: normalizeRateLimitReachedType(payload.rate_limit_reached_type)
+      };
+    }
+    function quotaFromCodexRateLimits2(rateLimits, source = "session", capturedAt = (/* @__PURE__ */ new Date()).toISOString()) {
       const primary = rateLimits?.primary;
       const secondary = rateLimits?.secondary;
       if (!primary && !secondary)
         return null;
       return {
-        fiveHour: primary ? { utilization: primary.used_percent, resetsAt: new Date(primary.resets_at * 1e3).toISOString() } : { utilization: 0, resetsAt: "" },
-        sevenDay: secondary ? { utilization: secondary.used_percent, resetsAt: new Date(secondary.resets_at * 1e3).toISOString() } : { utilization: 0, resetsAt: "" },
+        fiveHour: primary ? { utilization: normalizePercent(primary.used_percent), resetsAt: timestampToIso(primary.resets_at) } : { utilization: 0, resetsAt: "" },
+        sevenDay: secondary ? { utilization: normalizePercent(secondary.used_percent), resetsAt: timestampToIso(secondary.resets_at) } : { utilization: 0, resetsAt: "" },
         available: true,
         providerId: "codex",
         source,
         capturedAt,
         stale: source === "cache",
         fiveHourLabel: "Primary",
-        sevenDayLabel: "Secondary"
-      };
+        sevenDayLabel: "Secondary",
+        limitId: rateLimits?.limit_id,
+        limitName: rateLimits?.limit_name ?? void 0,
+        credits: rateLimits?.credits,
+        planType: rateLimits?.plan_type,
+        rateLimitReachedType: rateLimits?.rate_limit_reached_type
+      };
+    }
+    function readLatestCodexQuotaFromRollouts(sessionPaths, options = {}) {
+      const maxSessionFiles = options.maxSessionFiles ?? DEFAULT_MAX_SESSION_FILES;
+      const maxTailBytes = options.maxTailBytes ?? DEFAULT_TAIL_BYTES;
+      for (const sessionPath of sessionPaths.slice(0, maxSessionFiles)) {
+        const hit = readLatestQuotaFromRollout(sessionPath, maxTailBytes, options.source ?? "session");
+        if (hit)
+          return hit.quota;
+      }
+      return null;
+    }
+    function resolveCodexQuotaFromLocalSources(options = {}) {
+      const account = options.activeAccount !== void 0 ? options.activeAccount : (0, codexProfiles_1.getActiveCodexAccount)();
+      const readSnapshot = options.readSnapshot ?? quotaSnapshots_1.readQuotaSnapshot;
+      const writeSnapshot = options.writeSnapshot ?? quotaSnapshots_1.writeQuotaSnapshot;
+      const maxTailBytes = options.maxTailBytes ?? DEFAULT_TAIL_BYTES;
+      const maxSessionFiles = options.maxSessionFiles ?? DEFAULT_MAX_SESSION_FILES;
+      let ownProvider = false;
+      const provider = options.provider ?? (() => {
+        ownProvider = true;
+        return new codex_1.CodexProvider();
+      })();
+      try {
+        const workspaceSessions = options.workspacePath ? provider.findAllSessions(options.workspacePath) : [];
+        const workspaceQuota = readLatestCodexQuotaFromRollouts(workspaceSessions, { maxTailBytes, maxSessionFiles });
+        if (workspaceQuota) {
+          if (account)
+            writeSnapshot("codex", account.id, workspaceQuota);
+          return enrichCodexQuota(workspaceQuota, account);
+        }
+        const codexHome = options.codexHome ?? (0, codexProfiles_1.resolveSidekickCodexHome)();
+        const accountSessions = findRolloutFiles(path8.join(codexHome, "sessions"));
+        const accountQuota = readLatestCodexQuotaFromRollouts(accountSessions, { maxTailBytes, maxSessionFiles });
+        if (accountQuota) {
+          if (account)
+            writeSnapshot("codex", account.id, accountQuota);
+          return enrichCodexQuota(accountQuota, account);
+        }
+        const cached = account ? readSnapshot("codex", account.id) : null;
+        if (cached) {
+          return enrichCodexQuota({
+            ...cached,
+            providerId: "codex",
+            source: "cache",
+            stale: true,
+            fiveHourLabel: cached.fiveHourLabel ?? "Primary",
+            sevenDayLabel: cached.sevenDayLabel ?? "Secondary"
+          }, account);
+        }
+      } finally {
+        if (ownProvider)
+          provider.dispose();
+      }
+      return null;
+    }
+    async function resolveCodexQuota2(options = {}) {
+      const source = options.source ?? "local";
+      const account = options.activeAccount !== void 0 ? options.activeAccount : (0, codexProfiles_1.getActiveCodexAccount)();
+      const writeSnapshot = options.writeSnapshot ?? quotaSnapshots_1.writeQuotaSnapshot;
+      if (source === "api") {
+        const apiQuota = await fetchCodexQuotaFromApi(options);
+        if (apiQuota.available) {
+          if (account)
+            writeSnapshot("codex", account.id, apiQuota);
+          return enrichCodexQuota(apiQuota, account);
+        }
+        const fallback = resolveCodexQuotaFromLocalSources(options);
+        return fallback ?? enrichCodexQuota(apiQuota, account);
+      }
+      const local = resolveCodexQuotaFromLocalSources(options);
+      if (local)
+        return local;
+      if (source === "auto") {
+        const apiQuota = await fetchCodexQuotaFromApi(options);
+        if (apiQuota.available && account) {
+          writeSnapshot("codex", account.id, apiQuota);
+        }
+        return enrichCodexQuota(apiQuota, account);
+      }
+      return unavailableCodexQuota(account ? `No Codex rate-limit data is available for "${account.label ?? account.id}".` : "No Codex rate-limit data is available.", account, { source: "session" });
+    }
+    async function fetchCodexQuotaFromApi(options = {}) {
+      const capturedAt = options.capturedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+      const accessToken = options.accessToken ?? readCodexAccessToken(options.codexHome ?? (0, codexProfiles_1.resolveSidekickCodexHome)());
+      if (!accessToken) {
+        return {
+          fiveHour: { utilization: 0, resetsAt: "" },
+          sevenDay: { utilization: 0, resetsAt: "" },
+          available: false,
+          error: "Codex API refresh requires a ChatGPT login.",
+          failureKind: "auth",
+          providerId: "codex",
+          source: "api",
+          capturedAt,
+          fiveHourLabel: "Primary",
+          sevenDayLabel: "Secondary"
+        };
+      }
+      try {
+        const fetchImpl = options.fetchImpl ?? fetch;
+        const response = await fetchImpl(options.usageUrl ?? CHATGPT_USAGE_URL, {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: "application/json"
+          }
+        });
+        if (!response.ok) {
+          return {
+            fiveHour: { utilization: 0, resetsAt: "" },
+            sevenDay: { utilization: 0, resetsAt: "" },
+            available: false,
+            error: `Codex usage API error: ${response.status}`,
+            failureKind: response.status === 401 || response.status === 403 ? "auth" : response.status === 429 ? "rate_limit" : response.status >= 500 && response.status <= 599 ? "server" : "unknown",
+            httpStatus: response.status,
+            retryAfterMs: response.status === 429 ? parseRetryAfterMs(response.headers.get("retry-after")) : void 0,
+            providerId: "codex",
+            source: "api",
+            capturedAt,
+            fiveHourLabel: "Primary",
+            sevenDayLabel: "Secondary"
+          };
+        }
+        const payload = await response.json();
+        const quota = quotaFromCodexRateLimits2(rateLimitsFromUsagePayload(payload), "api", capturedAt);
+        if (!quota) {
+          return {
+            fiveHour: { utilization: 0, resetsAt: "" },
+            sevenDay: { utilization: 0, resetsAt: "" },
+            available: false,
+            error: "Codex usage API returned no rate-limit windows.",
+            failureKind: "unknown",
+            providerId: "codex",
+            source: "api",
+            capturedAt,
+            fiveHourLabel: "Primary",
+            sevenDayLabel: "Secondary"
+          };
+        }
+        return quota;
+      } catch {
+        return {
+          fiveHour: { utilization: 0, resetsAt: "" },
+          sevenDay: { utilization: 0, resetsAt: "" },
+          available: false,
+          error: "Codex usage API network error",
+          failureKind: "network",
+          providerId: "codex",
+          source: "api",
+          capturedAt,
+          fiveHourLabel: "Primary",
+          sevenDayLabel: "Secondary"
+        };
+      }
+    }
+    function readCodexAccessToken(codexHome) {
+      try {
+        const parsed = JSON.parse(fs9.readFileSync(path8.join(codexHome, "auth.json"), "utf8"));
+        if (parsed.OPENAI_API_KEY || parsed.auth_mode === "api_key")
+          return null;
+        return parsed.tokens?.access_token || null;
+      } catch {
+        return null;
+      }
+    }
+    function readLatestQuotaFromRollout(sessionPath, maxTailBytes, source) {
+      let fd = null;
+      try {
+        const stat = fs9.statSync(sessionPath);
+        if (!stat.isFile() || stat.size <= 0)
+          return null;
+        const start = Math.max(0, stat.size - maxTailBytes);
+        const bytesToRead = stat.size - start;
+        const buffer = Buffer.alloc(bytesToRead);
+        fd = fs9.openSync(sessionPath, "r");
+        const bytesRead = fs9.readSync(fd, buffer, 0, bytesToRead, start);
+        fs9.closeSync(fd);
+        fd = null;
+        let text = buffer.toString("utf8", 0, bytesRead);
+        if (start > 0) {
+          const firstNewline = text.indexOf("\n");
+          text = firstNewline >= 0 ? text.slice(firstNewline + 1) : "";
+        }
+        const lines = text.split("\n");
+        for (let i = lines.length - 1; i >= 0; i--) {
+          const line = lines[i].trim();
+          if (!line || !line.includes("rate_limits"))
+            continue;
+          try {
+            const parsed = JSON.parse(line);
+            if (parsed.type !== "event_msg" || parsed.payload?.type !== "token_count")
+              continue;
+            const quota = quotaFromCodexRateLimits2(parsed.payload.rate_limits, source, parsed.timestamp ?? new Date(stat.mtime).toISOString());
+            if (quota)
+              return { quota, filePath: sessionPath };
+          } catch {
+          }
+        }
+      } catch {
+        return null;
+      } finally {
+        if (fd !== null) {
+          try {
+            fs9.closeSync(fd);
+          } catch {
+          }
+        }
+      }
+      return null;
+    }
+    function findRolloutFiles(sessionsDir) {
+      const results = [];
+      function visit(dir) {
+        let entries;
+        try {
+          entries = fs9.readdirSync(dir, { withFileTypes: true });
+        } catch {
+          return;
+        }
+        for (const entry of entries) {
+          const fullPath = path8.join(dir, entry.name);
+          if (entry.isDirectory()) {
+            visit(fullPath);
+            continue;
+          }
+          if (!entry.isFile() || !entry.name.startsWith("rollout-") || !entry.name.endsWith(".jsonl"))
+            continue;
+          try {
+            const stat = fs9.statSync(fullPath);
+            if (stat.size > 0) {
+              results.push({ path: fullPath, mtime: stat.mtime.getTime() });
+            }
+          } catch {
+          }
+        }
+      }
+      visit(sessionsDir);
+      results.sort((a, b) => b.mtime - a.mtime);
+      return results.map((item) => item.path);
     }
   }
 });
@@ -19029,6 +19461,8 @@ var require_codexQuotaWatcher = __commonJS({
       readSnapshot;
       writeSnapshot;
       watchFile;
+      maxTailBytes;
+      maxSessionFiles;
       listeners = [];
       discoveryTimer;
       provider = null;
@@ -19045,6 +19479,8 @@ var require_codexQuotaWatcher = __commonJS({
         this.readSnapshot = options.readSnapshot ?? quotaSnapshots_1.readQuotaSnapshot;
         this.writeSnapshot = options.writeSnapshot ?? quotaSnapshots_1.writeQuotaSnapshot;
         this.watchFile = options.watchFile ?? fs9.watch;
+        this.maxTailBytes = options.maxTailBytes;
+        this.maxSessionFiles = options.maxSessionFiles;
       }
       start() {
         if (this.running)
@@ -19150,6 +19586,26 @@ var require_codexQuotaWatcher = __commonJS({
       }
       emitCachedOrUnavailable() {
         const account = this.getActiveAccount();
+        let localProvider = null;
+        try {
+          localProvider = this.providerFactory();
+          const local = (0, codexQuota_1.resolveCodexQuotaFromLocalSources)({
+            workspacePath: this.workspacePath,
+            activeAccount: account,
+            readSnapshot: this.readSnapshot,
+            writeSnapshot: this.writeSnapshot,
+            provider: localProvider,
+            maxTailBytes: this.maxTailBytes,
+            maxSessionFiles: this.maxSessionFiles
+          });
+          if (local) {
+            this.emitState(local);
+            return;
+          }
+        } catch {
+        } finally {
+          localProvider?.dispose();
+        }
         const cached = account ? this.readSnapshot("codex", account.id) : null;
         if (cached) {
           this.emitState(enrichQuotaState({
@@ -35961,8 +36417,8 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.findActiveClaudeSession = exports.discoverSessionDirectory = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.detectSessionActivity = exports.extractTaskInfo = exports.scanSubagentDir = exports.normalizeCodexToolInput = exports.normalizeCodexToolName = exports.extractPatchFilePaths = exports.CodexRolloutParser = exports.parseDbPartData = exports.parseDbMessageData = exports.convertOpenCodeMessage = exports.detectPlanModeFromText = exports.normalizeToolInput = exports.normalizeToolName = exports.TRUNCATION_PATTERNS = exports.JsonlParser = exports.CodexProvider = exports.OpenCodeProvider = exports.ClaudeCodeProvider = exports.getAllDetectedProviders = exports.detectProvider = exports.readClaudeCodePlanFiles = exports.getPlanAnalytics = exports.writePlans = exports.getLatestPlan = exports.readPlans = exports.readLatestHandoff = exports.readHistory = exports.readNotes = exports.readDecisions = exports.readTasks = exports.getProjectSlugRaw = exports.getProjectSlug = exports.encodeWorkspacePath = exports.getGlobalDataPath = exports.getProjectDataPath = exports.getConfigDir = exports.MAX_PLANS_PER_PROJECT = exports.PLAN_SCHEMA_VERSION = exports.createEmptyTokenTotals = exports.HISTORICAL_DATA_SCHEMA_VERSION = exports.STALENESS_THRESHOLDS = exports.IMPORTANCE_DECAY_FACTORS = exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = exports.DECISION_LOG_SCHEMA_VERSION = exports.normalizeTaskStatus = exports.TASK_PERSISTENCE_SCHEMA_VERSION = void 0;
     exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = exports.PHRASE_CATEGORIES = exports.ALL_PHRASES = exports.HIGHLIGHT_CSS = exports.clearHighlightCache = exports.highlightEvent = exports.formatSessionJson = exports.formatSessionMarkdown = exports.formatSessionText = exports.classifyNoise = exports.shouldMergeWithPrevious = exports.classifyFollowEvent = exports.classifyMessage = exports.getSoftNoiseReason = exports.isHardNoiseFollowEvent = exports.isHardNoise = exports.formatToolSummary = exports.formatTokenCount = exports.formatDurationMs = exports.createJsonlTail = exports.toFollowEvents = exports.createWatcher = exports.parseChangelog = exports.extractProposedPlanShared = exports.parsePlanMarkdownShared = exports.PlanExtractor = exports.composeContext = exports.FilterEngine = exports.searchSessions = exports.CodexDatabase = exports.OpenCodeDatabase = exports.discoverDebugLogs = exports.collapseDuplicates = exports.filterByLevel = exports.parseDebugLog = exports.scanSubagentTraces = exports.findAllSessionsWithWorktrees = exports.discoverWorktreeSiblings = exports.resolveWorktreeMainRepo = exports.getAllClaudeProjectFolders = exports.decodeEncodedPath = exports.getMostRecentlyActiveSessionDir = exports.findSubdirectorySessionDirs = exports.findSessionsInDirectory = exports.findAllClaudeSessions = void 0;
-    exports.quotaFromCodexRateLimits = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.fetchQuota = exports.removeCodexAccount = exports.switchToCodexAccount = exports.finalizeCodexAccount = exports.prepareCodexAccount = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getActiveCodexAccount = exports.listCodexAccounts = exports.getSystemCodexHome = exports.getCodexMonitoringHomes = exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.getActiveAccountStatus = exports.removeSavedAccountProfile = exports.replaceSavedAccountProfiles = exports.setActiveSavedAccount = exports.upsertSavedAccountProfile = exports.getActiveSavedAccount = exports.listSavedAccountProfiles = exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.isMultiAccountEnabled = exports.getActiveAccount = exports.listAccounts = exports.removeAccount = exports.switchToAccount = exports.addCurrentAccount = exports.readActiveClaudeAccount = exports.writeAccountRegistry = exports.readAccountRegistry = exports.ensureDefaultAccounts = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.writeActiveCredentials = exports.readActiveCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = void 0;
-    exports.fetchPeakHoursStatus = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.extractToolCalls = exports.extractToolCall = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.MultiProviderQuotaService = exports.CodexQuotaWatcher = void 0;
+    exports.fetchCodexQuotaFromApi = exports.writeQuotaSnapshot = exports.readQuotaSnapshot = exports.QuotaPoller = exports.describeQuotaFailure = exports.fetchQuota = exports.removeCodexAccount = exports.switchToCodexAccount = exports.finalizeCodexAccount = exports.prepareCodexAccount = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getActiveCodexAccount = exports.listCodexAccounts = exports.getSystemCodexHome = exports.getCodexMonitoringHomes = exports.getCodexProfileHome = exports.getCodexProfilesDir = exports.getActiveAccountStatus = exports.removeSavedAccountProfile = exports.replaceSavedAccountProfiles = exports.setActiveSavedAccount = exports.upsertSavedAccountProfile = exports.getActiveSavedAccount = exports.listSavedAccountProfiles = exports.writeSavedAccountRegistry = exports.readSavedAccountRegistry = exports.getAccountsDir = exports.isMultiAccountEnabled = exports.getActiveAccount = exports.listAccounts = exports.removeAccount = exports.switchToAccount = exports.addCurrentAccount = exports.readActiveClaudeAccount = exports.writeAccountRegistry = exports.readAccountRegistry = exports.ensureDefaultAccounts = exports.readClaudeMaxAccessTokenSync = exports.readClaudeMaxCredentials = exports.writeActiveCredentials = exports.readActiveCredentials = exports.openInBrowser = exports.parseTranscript = exports.generateHtmlReport = exports.PatternExtractor = exports.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = void 0;
+    exports.fetchPeakHoursStatus = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.extractToolCalls = exports.extractToolCall = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.sortModelIds = exports.compareModelIds = exports.getModelDisplayInfo = exports.shortModelName = exports.mergeCostSources = exports.calculateCostWithProvenance = exports.calculateCostWithPricing = exports.calculateCost = exports.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = exports.MultiProviderQuotaService = exports.CodexQuotaWatcher = exports.resolveCodexQuotaFromLocalSources = exports.resolveCodexQuota = exports.readLatestCodexQuotaFromRollouts = exports.quotaFromCodexRateLimits = void 0;
     var taskPersistence_1 = require_taskPersistence();
     Object.defineProperty(exports, "TASK_PERSISTENCE_SCHEMA_VERSION", { enumerable: true, get: function() {
       return taskPersistence_1.TASK_PERSISTENCE_SCHEMA_VERSION;
@@ -36468,9 +36924,21 @@ var require_dist = __commonJS({
       return quotaSnapshots_1.writeQuotaSnapshot;
     } });
     var codexQuota_1 = require_codexQuota();
+    Object.defineProperty(exports, "fetchCodexQuotaFromApi", { enumerable: true, get: function() {
+      return codexQuota_1.fetchCodexQuotaFromApi;
+    } });
     Object.defineProperty(exports, "quotaFromCodexRateLimits", { enumerable: true, get: function() {
       return codexQuota_1.quotaFromCodexRateLimits;
     } });
+    Object.defineProperty(exports, "readLatestCodexQuotaFromRollouts", { enumerable: true, get: function() {
+      return codexQuota_1.readLatestCodexQuotaFromRollouts;
+    } });
+    Object.defineProperty(exports, "resolveCodexQuota", { enumerable: true, get: function() {
+      return codexQuota_1.resolveCodexQuota;
+    } });
+    Object.defineProperty(exports, "resolveCodexQuotaFromLocalSources", { enumerable: true, get: function() {
+      return codexQuota_1.resolveCodexQuotaFromLocalSources;
+    } });
     var codexQuotaWatcher_1 = require_codexQuotaWatcher();
     Object.defineProperty(exports, "CodexQuotaWatcher", { enumerable: true, get: function() {
       return codexQuotaWatcher_1.CodexQuotaWatcher;
@@ -38803,7 +39271,7 @@ var init_UpdateCheckService = __esm({
       /** Run the update check (one-shot). */
       async check() {
         try {
-          const current = "0.18.1";
+          const current = "0.18.2";
           const cached = this.readCache();
           let latest;
           if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
@@ -79420,7 +79888,7 @@ function StatusBar({
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: parseBlessedTags(BRAND_INLINE) }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { dimColor: true, children: [
         " v",
-        "0.18.1"
+        "0.18.2"
       ] }),
       updateInfo && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { color: "yellow", children: [
         " (v",
@@ -79810,7 +80278,7 @@ function ChangelogOverlay({ entries, scrollOffset }) {
       "  ",
       /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { bold: true, color: "cyan", children: [
         "Terminal Dashboard v",
-        "0.18.1"
+        "0.18.2"
       ] }),
       latestDate ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { color: "gray", children: [
         " \u2014 ",
@@ -80132,7 +80600,7 @@ var init_mouse = __esm({
 var CHANGELOG_default;
 var init_CHANGELOG = __esm({
   "CHANGELOG.md"() {
-    CHANGELOG_default = '# Changelog\n\nAll notable changes to the Sidekick Agent Hub CLI will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [0.18.1] - 2026-05-08\n\n### Changed\n\n- **Shared dashboard formatting**: terminal dashboard `fmtNum()` and `formatDuration()` now delegate to `formatTokenCount()` and `formatDurationMs()` from `sidekick-shared`, keeping the existing CLI surface (uppercase `K`/`M` suffix, compact `1m5s` style) while removing forked rounding logic\n\n## [0.18.0] - 2026-05-08\n\n### Changed\n\n- **Bundled `sidekick-shared` 0.18.0**: Picks up the new provider-aware quota orchestration surface \u2014 `MultiProviderQuotaService`, `CodexQuotaWatcher`, `getActiveAccountStatus()`, `extractToolCall()`, cost-provenance helpers (`calculateCostWithProvenance`, `mergeCostSources`), and model display helpers (`shortModelName`, `getModelDisplayInfo`, `compareModelIds`, `sortModelIds`). `parseModelId()` also now recognizes legacy Claude IDs such as `claude-3-opus-20240229` and `claude-3-5-sonnet-20241022`\n- **No CLI runtime changes**: This release ships the shared library upgrade for downstream tooling alignment; `sidekick quota`, `sidekick status`, and the live dashboard keep using the existing polling path. Wiring the new orchestrator into the CLI will land in a follow-up release\n\n## [0.17.7] - 2026-04-28\n\n### Fixed\n\n- **Quota snapshot write race**: Updated the bundled `sidekick-shared` snapshot writer so concurrent `sidekick quota` / Codex session updates no longer collide on `quota-snapshots.json.tmp` or throw `ENOENT`. Failed writes now also clean up their partial temp files instead of leaving orphans in `~/.config/sidekick/`\n\n## [0.17.6] - 2026-04-19\n\n### Added\n\n- **`sidekick peak` command**: One-shot check for Claude\'s current peak-hours state \u2014 weekdays 13:00\u201319:00 UTC, when session limits drain faster on Free/Pro/Max/Team subscriptions. Prints a color-coded status block with a countdown to the next transition. Data comes from the public `promoclock.co/api/status` endpoint (third-party, unaffiliated with Anthropic) with a graceful fallback when unreachable. `--json` emits the full raw state\n- **Peak-hours block in `sidekick status`**: When the active provider is `claude-code`, the Claude + OpenAI health blocks are now followed by a **Claude Peak Hours** block (off-peak or in-peak, with countdown). Gated on the provider so OpenCode / Codex users don\'t trigger an unnecessary third-party fetch. `--json` output includes the new `peak` field\n- **Peak-hours summary in `sidekick quota`**: Claude subscription quota output now shows a **Peak** line under the 5-hour / 7-day bars \u2014 green dot off-peak, orange dot during an active peak, with a countdown to the next transition. `--json` output includes the new `peak` field\n\n## [0.17.5] - 2026-04-18\n\n### Added\n\n- **Default account bootstrap at CLI startup**: The CLI now calls `ensureDefaultAccounts()` from `sidekick-shared` at module load and awaits the result inside a Commander `preAction` hook, so the first real subcommand blocks briefly on the bootstrap while `--version` and `--help` stay instant. When a system Claude Code or Codex credential exists and no saved account is active for that provider yet, the CLI registers it as "Default" \u2014 `sidekick quota`, `sidekick account`, and `sidekick stats` now reflect the active account on first run without requiring an explicit `sidekick account --add` first. Idempotent, never overwrites manually saved accounts, and all errors are swallowed so startup is never blocked\n\nThanks to [@B33pBeeps](https://github.com/B33pBeeps) (Juan Fourie) for contributing this feature in [#16](https://github.com/cesarandreslopez/sidekick-agent-hub/pull/16).\n\n## [0.17.4] - 2026-04-17\n\n### Changed\n\n- **Pricing hydration import migrated to `sidekick-shared/node`**: `cli.ts` now imports `hydratePricingCatalog` from the new Node-only subpath and keeps `detectProvider` on the package root. Runtime behavior is unchanged; the split makes the CLI\'s import surface self-documenting (hydration is explicitly a Node API) and aligns the CLI with the shared library\'s new versioned public API contract\n\n## [0.17.3] - 2026-04-17\n\n### Changed\n\n- **Version sync with the VS Code extension**: Republished to keep CLI, extension, and shared-library versions aligned after a cosmetic changelog fix in 0.17.3. No CLI code changes \u2014 functionally identical to 0.17.2\n\n## [0.17.2] - 2026-04-17\n\n### Added\n\n- **LiteLLM pricing hydration on startup**: The CLI now fetches the LiteLLM pricing catalog on startup and caches to `~/.config/sidekick/pricing-catalog.json` with a 24-hour TTL, 3s timeout, and stale-cache fallback \u2014 new model prices are picked up without a CLI upgrade\n- **Expanded pricing coverage**: GPT-4o, GPT-4.1, GPT-5.x, o1, o3, and o3-mini families are now priced alongside the existing Claude entries\n- **Real-dollar Codex / Claude Code costs**: `EventAggregator` computes cost from the pricing table when the session provider doesn\'t report one, so `sidekick` live dashboards now show actual dollars for Codex and Claude Code sessions\n- **`stats` footer lists unpriced models**: `sidekick stats` prints any models encountered with no pricing entry so missing coverage is visible\n\n### Fixed\n\n- **Context-gauge % wrong for Opus 4.7 (1M) and other new models**: The dashboard\'s context gauge was dividing by 200K for Claude Opus 4.7 (native 1M), inflating the displayed %. The shared model \u2192 context-window map now includes Opus/Sonnet 4.7 (1M), GPT-5.4 (1.05M), GPT-5.3-Codex (400K), and GPT-5.3-Codex-Spark (128K). Claude Code\'s `[1m]` suffix is now also honored as an explicit 1M marker\n- **Silent Sonnet-priced fallback for unknown models**: Codex, GPT-5.x, and o-series rows were being rendered at Sonnet rates. Unknown-model rows now render as `\u2014` in yellow instead of inventing a dollar figure\n\n### Changed\n\n- **`historical-data.json` schema v2**: reads `priced` flag and `unpricedModelIds` from records written by the latest VS Code extension; v1 records still read correctly\n\n## [0.17.1] - 2026-04-13\n\n### Fixed\n\n- **Codex multi-home session discovery**: Provider detection now scans all candidate Codex home directories, fixing missed sessions when the managed profile home is empty but the system `~/.codex/` has activity\n\n## [0.17.0] - 2026-04-13\n\n### Added\n\n- **Multi-provider account management**: `sidekick account` now supports `--provider codex` for Codex profile management alongside Claude Code accounts\n- **Codex account lifecycle**: `--add` prepares a profile and spawns `codex login`; `--switch-to` and `--remove` accept email, label, or profile ID\n- **Quota snapshot fallback**: `sidekick quota` for Codex shows cached rate-limit snapshots when no active session exists, with "cached from" timestamp\n\n### Fixed\n\n- **Email normalization**: Claude account lookup normalizes email case for reliable matching\n\n## [0.16.1] - 2026-03-27\n\n### Fixed\n\n- **Dashboard provider status scoping**: The TUI now shows degraded-service notices only for the monitored provider \u2014 Claude for Claude Code sessions, OpenAI for Codex sessions, and no status banner for OpenCode\n\n## [0.16.0] - 2026-03-23\n\n### Changed\n\n- **Consistent cost formatting**: All cost displays (`stats`, `context`, Sessions panel, narrative prompt) now use shared `formatCost()` with intelligent decimal precision (4 places for < $0.01, 2 otherwise)\n- **QuotaService**: Rewritten to wrap shared `QuotaPoller` with exponential backoff instead of manual polling loop\n- **modelContext**: Now re-exports `getModelInfo` from shared library alongside `getContextWindowSize`\n\n## [0.15.2] - 2026-03-18\n\n### Fixed\n\n- **CLI help descriptions**: Updated `quota` and `status` command descriptions to reflect provider-aware behavior\n- **`sidekick quota --provider`**: Added local `--provider` option so `sidekick quota --provider codex` works naturally\n\n## [0.15.0] - 2026-03-18\n\n### Added\n\n- **OpenAI status page monitoring**: CLI dashboard now shows OpenAI API status alongside Claude API status\n- **Codex rate limits in dashboard**: Sessions panel displays Codex rate-limit data with "Rate Limits" header instead of "Quota"\n- **Provider-aware `sidekick quota` command**: Detects active provider and shows Codex rate limits, Claude subscription quota, or an informational message for OpenCode\n\n### Fixed\n\n- **QuotaService polling for Codex**: Dashboard no longer starts Claude OAuth quota polling when the active provider is Codex\n\n## [0.14.2] - 2026-03-16\n\n### Fixed\n\n- **Quota polling interval**: Reduced quota refresh from every 30 seconds to every 5 minutes to avoid unnecessary API calls\n- **SessionsPanel `detailWidth()` call**: Removed unused parameter from `detailWidth()` in the Sessions panel quota rendering\n\n## [0.14.1] - 2026-03-14\n\n### Fixed\n\n- **Per-model context window sizes**: Dashboard context gauge now shows correct utilization for Claude Opus 4.6 (1M context) and other models with non-200K windows\n\n### Changed\n\n- **Shared model context lookup**: CLI dashboard now uses the centralized `getModelContextWindowSize()` from `sidekick-shared` instead of a local duplicate map\n\n## [0.14.0] - 2026-03-12\n\n### Added\n\n- **`sidekick account` Command**: Manage Claude Code accounts from the terminal \u2014 list saved accounts, add the current account with an optional label, switch to the next or a specific account, and remove accounts. Supports `--json` output for scripting\n- **Quota Account Label**: `sidekick quota` now shows the active account email and label above the quota bars when multi-account is enabled\n- **macOS Keychain Support**: `sidekick account` and `sidekick quota` now read and write credentials via the system Keychain on macOS, fixing account switching and quota checks on Mac\n\n## [0.13.8] - 2026-03-12\n\n### Changed\n\n- **Structured quota failure output**: `sidekick quota` now renders consistent auth, rate-limit, server, network, and unexpected-failure copy from shared quota failure descriptors while preserving `--json` machine-readable output\n- **Dashboard unavailable quota rendering**: The Sessions panel now shows Claude Code quota failures inline instead of hiding the quota section whenever subscription data is unavailable\n- **Quota transition toasts**: The Ink dashboard now fires low-noise toast notifications only when Claude Code quota failure state changes, avoiding repeated alerts every polling interval\n\n## [0.13.7] - 2026-03-11\n\n### Changed\n\n- **npm README sync**: Updated the published CLI package README to reflect current OpenCode monitoring behavior, platform-specific data directories, and the `sqlite3` runtime requirement\n- **README badge cleanup**: Removed the Ask DeepWiki badge from the published CLI package README; the repo root README still keeps it\n\n## [0.13.6] - 2026-03-11\n\n### Changed\n\n- **Refreshed CLI Dashboard Wordmark**: Updated the dashboard wordmark/header styling for a cleaner splash and dashboard identity\n\n### Fixed\n\n- **OpenCode dashboard startup**: OpenCode DB-backed session discovery now resolves projects by worktree, sandboxes, and session directory instead of quietly behaving like no session exists\n- **OpenCode runtime notices**: The CLI now prints an OpenCode-only actionable notice when `opencode.db` exists but `sqlite3` is missing, blocked, or otherwise unusable in the current shell environment\n\n## [0.13.5] - 2026-03-10\n\n### Added\n\n- **`sidekick status` Command**: One-shot Claude API status check with color-coded text output and `--json` mode\n- **Dashboard Status Banner**: Status bar shows a colored `\u25CF API minor/major/critical` indicator when Claude is degraded; Sessions panel Summary tab shows an "API Status" section with affected components and active incident details. Polls every 60s\n\n## [0.13.4] - 2026-03-08\n\n### Fixed\n\n- **Onboarding Phrase Spam**: Splash screen and detail pane motivational phrases memoized \u2014 no longer flicker every render tick (fixes [#13](https://github.com/cesarandreslopez/sidekick-agent-hub/issues/13))\n\n### Changed\n\n- **Simplified Logo**: Replaced 6-line ASCII robot art with compact text header in splash, help, and changelog overlays\n- **Removed Dead Code**: Removed unused `getSplashContent()` and `HELP_HEADER` exports from branding module\n\n## [0.13.3] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.2] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.1] - 2026-03-04\n\n### Added\n\n- **`sidekick quota` Command**: One-shot subscription quota check showing 5-hour and 7-day utilization with color-coded progress bars and reset countdowns \u2014 supports `--json` for machine-readable output\n- **Quota Projections**: Elapsed-time projections shown in `sidekick quota` output and TUI dashboard quota section \u2014 displays projected end-of-window utilization next to current value (e.g., `40% \u2192 100%`), included in `--json` output as `projectedFiveHour` / `projectedSevenDay`\n\n## [0.13.0] - 2026-03-03\n\n_No CLI-specific changes in this release._\n\n## [0.12.10] - 2026-03-01\n\n### Added\n\n- **Events Panel** (key 7): Scrollable live event stream with colored type badges (`[USR]`, `[AST]`, `[TOOL]`, `[RES]`), timestamps, and keyword-highlighted summaries; detail tabs for full event JSON and surrounding context\n- **Charts Panel** (key 8): Tool frequency horizontal bars, event type distribution, 60-minute activity heatmap using `\u2591\u2592\u2593\u2588` intensity characters, and pattern analysis with frequency bars and template text\n- **Multi-Mode Filter**: `/` filter overlay now supports four modes \u2014 substring, fuzzy, regex, and date range \u2014 Tab cycles modes, regex mode shows red validation errors\n- **Search Term Highlighting**: Active filter terms highlighted in blue within side list items\n- **Timeline Keyword Coloring**: Event summaries in the Sessions panel Timeline tab now use semantic keyword coloring \u2014 errors red, success green, tool names cyan, file paths magenta\n\n### Removed\n\n- **Search Panel**: Removed redundant Search panel (previously key 7) \u2014 the `/` filter with multi-mode support serves the same purpose\n\n## [0.12.9] - 2026-02-28\n\n### Added\n\n- **Standalone Data Commands**: `sidekick tasks`, `sidekick decisions`, `sidekick notes`, `sidekick stats`, `sidekick handoff` for accessing project data without launching the TUI\n- **`sidekick search <query>`**: Cross-session full-text search from the terminal\n- **`sidekick context`**: Composite output of tasks, decisions, notes, and handoff for piping into other tools\n- **`--list` flag on `sidekick dump`**: Discover available session IDs before requiring `--session <id>`\n- **Search Panel**: Search panel (panel 7) wired into the TUI dashboard\n\n### Changed\n\n- **`taskMerger` utility**: Duplicate `mergeTasks` logic extracted into shared `taskMerger` utility\n- **Model constants**: Hardcoded model IDs extracted to named constants\n\n### Fixed\n\n- **`convention` icon**: Notes panel icon replaced with valid `tip` type\n- **Linux clipboard**: Now supports Wayland (`wl-copy`) and `xsel` fallbacks, with error messages instead of silent failure\n- **`provider.dispose()`**: Added to `dump` and `report` commands (prevents SQLite connection leaks)\n\n## [0.12.8] - 2026-02-28\n\n### Changed\n\n- **Dashboard UI/UX Polish**: Visual overhaul for better hierarchy, consistency, and readability\n  - Splash screen and help overlay now display the robot ASCII logo\n  - Toast notifications show severity icons (\u2718 error, \u26A0 warning, \u25CF info) with inner padding\n  - Focused pane uses double-border for clear focus indication\n  - Section dividers (`\u2500\u2500 Title \u2500\u2500\u2500\u2500`) replace bare bold headers in summary, agents, and context attribution\n  - Tab bar: active tab underlined in magenta, inactive tabs dimmed, bracket syntax removed\n  - Status bar: segmented layout with `\u2502` separators; keys bold, labels dim\n  - Summary metrics condensed: elapsed/events/compactions on one line, tokens on one line with cache rate and cost\n  - Sparklines display peak metadata annotations\n  - Progress bars use blessed color tags for consistent coloring\n  - Help overlay uses dot-leader alignment for all keybinding rows\n  - Empty state hints per panel (e.g. "Tasks appear as your agent works.")\n  - Session picker groups sessions by provider with section headers when multiple providers are present\n\n## [0.12.7] - 2026-02-27\n\n### Added\n\n- **HTML Session Report**: `sidekick report` command generates a self-contained HTML report and opens it in the default browser\n  - Options: `--session`, `--output`, `--theme` (dark/light), `--no-open`, `--no-thinking`\n  - TUI Dashboard: press `r` to generate and open an HTML report for the current session\n\n## [0.12.6] - 2026-02-26\n\n### Added\n\n- **Session Dump Command**: `sidekick dump` exports session data in text, markdown, or JSON format with `--format`, `--width`, and `--expand` options\n- **Plans Panel Re-enabled**: Plans panel restored in CLI dashboard with plan file discovery from `~/.claude/plans/`\n- **Enhanced Status Bar**: Session info display improved with richer metadata\n\n### Fixed\n\n- **Old snapshot format migration**: Restoring pre-0.12.3 session snapshots no longer shows empty timeline entries\n\n### Changed\n\n- **Phrase library moved to shared**: CLI-specific phrase formatting kept local, all phrase content now from `sidekick-shared`\n\n## [0.12.5] - 2026-02-24\n\n### Fixed\n\n- **Update check too slow to notice new versions**: Reduced npm registry cache TTL from 24 hours to 4 hours so upgrade notices appear sooner after a new release\n\n## [0.12.4] - 2026-02-24\n\n### Fixed\n\n- **Session crash on upgrade**: Fixed `d.timestamp.getTime is not a function` error when restoring tool call data from session snapshots \u2014 `Date` objects were serialized to strings by JSON but not rehydrated on restore, causing the session monitor to crash on first run after upgrading from 0.12.2 to 0.12.3\n\n## [0.12.3] - 2026-02-24\n\n### Added\n\n- **Latest-node indicator**: The most recently added node in tree and boxed mind map views is now marked with a yellow indicator\n- **Plan analytics in mind map**: Tree and boxed views now display plan progress and per-step metrics\n  - Tree view: plan header shows completion stats; steps show complexity, duration, tokens, tool calls, and errors in metadata brackets\n  - Box view: progress bar with completion percentage; steps show right-aligned metrics; subtitle shows step count and total duration\n- **Cross-provider plan extraction**: Shared `PlanExtractor` now handles Claude Code (EnterPlanMode/ExitPlanMode) and OpenCode (`<proposed_plan>` XML) plans \u2014 previously only Codex plans were shown\n- **Enriched plan data model**: Plan steps include duration, token count, tool call count, and error messages\n- **Phase-grouped plan display**: When a plan has phase structure, tree and boxed views group steps under phase headers with context lines from the original plan markdown\n- **Node type filter**: Press `f` on the Mind Map tab to cycle through node type filters (file, tool, task, subagent, command, plan, knowledge-note) \u2014 non-matching sections render dimmed in grey\n\n### Fixed\n\n- **Kanban board regression**: Subagent and plan-step tasks now correctly appear in the kanban board\n\n### Changed\n\n- **Plans panel temporarily disabled**: The Plans panel in the CLI dashboard is disabled until plan-mode event capture is reliably working end-to-end. Plan nodes in the mind map remain active.\n- `DashboardState` now delegates to shared `EventAggregator` instead of maintaining its own aggregation logic\n\n## [0.12.2] - 2026-02-23\n\n### Added\n\n- **Update notifications**: The dashboard now checks the npm registry for newer versions on startup and shows a yellow banner in the status bar when an update is available (e.g., `v0.13.0 available \u2014 npm i -g sidekick-agent-hub`). Results are cached for 24 hours to avoid repeated network requests.\n\n## [0.12.1] - 2026-02-23\n\n### Fixed\n\n- **VS Code integration**: Fixed exit code 127 when the extension launches the CLI dashboard on systems using nvm or volta (node binary not found when shell init is bypassed)\n\n## [0.12.0] - 2026-02-22\n\n### Added\n\n- **"Open CLI Dashboard" VS Code Integration**: New VS Code command `Sidekick: Open CLI Dashboard` launches the TUI dashboard in an integrated terminal\n  - Install the CLI with `npm install -g sidekick-agent-hub`\n\n## [0.11.0] - 2026-02-19\n\n### Added\n\n- **Initial Release**: Full-screen TUI dashboard for monitoring agent sessions from the terminal\n  - Ink-based terminal UI with panels for sessions, tasks, kanban, mind map, notes, decisions, search, files, and git diff\n  - Multi-provider support: auto-detects Claude Code, OpenCode, and Codex sessions\n  - Reads from `~/.config/sidekick/` \u2014 the same data files the VS Code extension writes\n  - Usage: `sidekick dashboard [--project <path>] [--provider <id>]`\n';
+    CHANGELOG_default = '# Changelog\n\nAll notable changes to the Sidekick Agent Hub CLI will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [0.18.2] - 2026-05-19\n\n### Added\n\n- **`sidekick quota --refresh`**: New flag on the `quota` command that, for Codex, explicitly refreshes from the ChatGPT usage API before falling back to local rollout data and cached snapshots. Without the flag, the Codex quota path stays fully local and makes no upstream network call\n\n### Changed\n\n- **Codex quota is local-only by default**: `sidekick quota --provider codex` now delegates to the new `resolveCodexQuota` orchestrator in `sidekick-shared`. It checks the current workspace\'s most recent rollout, then recent account-level rollouts under `CODEX_HOME/sessions`, then the active account\'s cached snapshot \u2014 no upstream network call unless `--refresh` is passed. Failure output continues to include structured `failureKind` / `httpStatus` / `retryAfterMs` fields under `--json`\n- **Bundled `sidekick-shared` 0.18.2**: Picks up the new Codex quota orchestrator (`resolveCodexQuota`, `resolveCodexQuotaFromLocalSources`, `readLatestCodexQuotaFromRollouts`, `fetchCodexQuotaFromApi`), the relaxed `CodexRateLimits` shape (nullable `resets_at` / `window_minutes`), the rate-limit-only `token_count` event emission in `JsonlSessionWatcher`, and `state_N.sqlite` discovery in `CodexDatabase` + provider auto-detect\n\n## [0.18.1] - 2026-05-08\n\n### Changed\n\n- **Shared dashboard formatting**: terminal dashboard `fmtNum()` and `formatDuration()` now delegate to `formatTokenCount()` and `formatDurationMs()` from `sidekick-shared`, keeping the existing CLI surface (uppercase `K`/`M` suffix, compact `1m5s` style) while removing forked rounding logic\n\n## [0.18.0] - 2026-05-08\n\n### Changed\n\n- **Bundled `sidekick-shared` 0.18.0**: Picks up the new provider-aware quota orchestration surface \u2014 `MultiProviderQuotaService`, `CodexQuotaWatcher`, `getActiveAccountStatus()`, `extractToolCall()`, cost-provenance helpers (`calculateCostWithProvenance`, `mergeCostSources`), and model display helpers (`shortModelName`, `getModelDisplayInfo`, `compareModelIds`, `sortModelIds`). `parseModelId()` also now recognizes legacy Claude IDs such as `claude-3-opus-20240229` and `claude-3-5-sonnet-20241022`\n- **No CLI runtime changes**: This release ships the shared library upgrade for downstream tooling alignment; `sidekick quota`, `sidekick status`, and the live dashboard keep using the existing polling path. Wiring the new orchestrator into the CLI will land in a follow-up release\n\n## [0.17.7] - 2026-04-28\n\n### Fixed\n\n- **Quota snapshot write race**: Updated the bundled `sidekick-shared` snapshot writer so concurrent `sidekick quota` / Codex session updates no longer collide on `quota-snapshots.json.tmp` or throw `ENOENT`. Failed writes now also clean up their partial temp files instead of leaving orphans in `~/.config/sidekick/`\n\n## [0.17.6] - 2026-04-19\n\n### Added\n\n- **`sidekick peak` command**: One-shot check for Claude\'s current peak-hours state \u2014 weekdays 13:00\u201319:00 UTC, when session limits drain faster on Free/Pro/Max/Team subscriptions. Prints a color-coded status block with a countdown to the next transition. Data comes from the public `promoclock.co/api/status` endpoint (third-party, unaffiliated with Anthropic) with a graceful fallback when unreachable. `--json` emits the full raw state\n- **Peak-hours block in `sidekick status`**: When the active provider is `claude-code`, the Claude + OpenAI health blocks are now followed by a **Claude Peak Hours** block (off-peak or in-peak, with countdown). Gated on the provider so OpenCode / Codex users don\'t trigger an unnecessary third-party fetch. `--json` output includes the new `peak` field\n- **Peak-hours summary in `sidekick quota`**: Claude subscription quota output now shows a **Peak** line under the 5-hour / 7-day bars \u2014 green dot off-peak, orange dot during an active peak, with a countdown to the next transition. `--json` output includes the new `peak` field\n\n## [0.17.5] - 2026-04-18\n\n### Added\n\n- **Default account bootstrap at CLI startup**: The CLI now calls `ensureDefaultAccounts()` from `sidekick-shared` at module load and awaits the result inside a Commander `preAction` hook, so the first real subcommand blocks briefly on the bootstrap while `--version` and `--help` stay instant. When a system Claude Code or Codex credential exists and no saved account is active for that provider yet, the CLI registers it as "Default" \u2014 `sidekick quota`, `sidekick account`, and `sidekick stats` now reflect the active account on first run without requiring an explicit `sidekick account --add` first. Idempotent, never overwrites manually saved accounts, and all errors are swallowed so startup is never blocked\n\nThanks to [@B33pBeeps](https://github.com/B33pBeeps) (Juan Fourie) for contributing this feature in [#16](https://github.com/cesarandreslopez/sidekick-agent-hub/pull/16).\n\n## [0.17.4] - 2026-04-17\n\n### Changed\n\n- **Pricing hydration import migrated to `sidekick-shared/node`**: `cli.ts` now imports `hydratePricingCatalog` from the new Node-only subpath and keeps `detectProvider` on the package root. Runtime behavior is unchanged; the split makes the CLI\'s import surface self-documenting (hydration is explicitly a Node API) and aligns the CLI with the shared library\'s new versioned public API contract\n\n## [0.17.3] - 2026-04-17\n\n### Changed\n\n- **Version sync with the VS Code extension**: Republished to keep CLI, extension, and shared-library versions aligned after a cosmetic changelog fix in 0.17.3. No CLI code changes \u2014 functionally identical to 0.17.2\n\n## [0.17.2] - 2026-04-17\n\n### Added\n\n- **LiteLLM pricing hydration on startup**: The CLI now fetches the LiteLLM pricing catalog on startup and caches to `~/.config/sidekick/pricing-catalog.json` with a 24-hour TTL, 3s timeout, and stale-cache fallback \u2014 new model prices are picked up without a CLI upgrade\n- **Expanded pricing coverage**: GPT-4o, GPT-4.1, GPT-5.x, o1, o3, and o3-mini families are now priced alongside the existing Claude entries\n- **Real-dollar Codex / Claude Code costs**: `EventAggregator` computes cost from the pricing table when the session provider doesn\'t report one, so `sidekick` live dashboards now show actual dollars for Codex and Claude Code sessions\n- **`stats` footer lists unpriced models**: `sidekick stats` prints any models encountered with no pricing entry so missing coverage is visible\n\n### Fixed\n\n- **Context-gauge % wrong for Opus 4.7 (1M) and other new models**: The dashboard\'s context gauge was dividing by 200K for Claude Opus 4.7 (native 1M), inflating the displayed %. The shared model \u2192 context-window map now includes Opus/Sonnet 4.7 (1M), GPT-5.4 (1.05M), GPT-5.3-Codex (400K), and GPT-5.3-Codex-Spark (128K). Claude Code\'s `[1m]` suffix is now also honored as an explicit 1M marker\n- **Silent Sonnet-priced fallback for unknown models**: Codex, GPT-5.x, and o-series rows were being rendered at Sonnet rates. Unknown-model rows now render as `\u2014` in yellow instead of inventing a dollar figure\n\n### Changed\n\n- **`historical-data.json` schema v2**: reads `priced` flag and `unpricedModelIds` from records written by the latest VS Code extension; v1 records still read correctly\n\n## [0.17.1] - 2026-04-13\n\n### Fixed\n\n- **Codex multi-home session discovery**: Provider detection now scans all candidate Codex home directories, fixing missed sessions when the managed profile home is empty but the system `~/.codex/` has activity\n\n## [0.17.0] - 2026-04-13\n\n### Added\n\n- **Multi-provider account management**: `sidekick account` now supports `--provider codex` for Codex profile management alongside Claude Code accounts\n- **Codex account lifecycle**: `--add` prepares a profile and spawns `codex login`; `--switch-to` and `--remove` accept email, label, or profile ID\n- **Quota snapshot fallback**: `sidekick quota` for Codex shows cached rate-limit snapshots when no active session exists, with "cached from" timestamp\n\n### Fixed\n\n- **Email normalization**: Claude account lookup normalizes email case for reliable matching\n\n## [0.16.1] - 2026-03-27\n\n### Fixed\n\n- **Dashboard provider status scoping**: The TUI now shows degraded-service notices only for the monitored provider \u2014 Claude for Claude Code sessions, OpenAI for Codex sessions, and no status banner for OpenCode\n\n## [0.16.0] - 2026-03-23\n\n### Changed\n\n- **Consistent cost formatting**: All cost displays (`stats`, `context`, Sessions panel, narrative prompt) now use shared `formatCost()` with intelligent decimal precision (4 places for < $0.01, 2 otherwise)\n- **QuotaService**: Rewritten to wrap shared `QuotaPoller` with exponential backoff instead of manual polling loop\n- **modelContext**: Now re-exports `getModelInfo` from shared library alongside `getContextWindowSize`\n\n## [0.15.2] - 2026-03-18\n\n### Fixed\n\n- **CLI help descriptions**: Updated `quota` and `status` command descriptions to reflect provider-aware behavior\n- **`sidekick quota --provider`**: Added local `--provider` option so `sidekick quota --provider codex` works naturally\n\n## [0.15.0] - 2026-03-18\n\n### Added\n\n- **OpenAI status page monitoring**: CLI dashboard now shows OpenAI API status alongside Claude API status\n- **Codex rate limits in dashboard**: Sessions panel displays Codex rate-limit data with "Rate Limits" header instead of "Quota"\n- **Provider-aware `sidekick quota` command**: Detects active provider and shows Codex rate limits, Claude subscription quota, or an informational message for OpenCode\n\n### Fixed\n\n- **QuotaService polling for Codex**: Dashboard no longer starts Claude OAuth quota polling when the active provider is Codex\n\n## [0.14.2] - 2026-03-16\n\n### Fixed\n\n- **Quota polling interval**: Reduced quota refresh from every 30 seconds to every 5 minutes to avoid unnecessary API calls\n- **SessionsPanel `detailWidth()` call**: Removed unused parameter from `detailWidth()` in the Sessions panel quota rendering\n\n## [0.14.1] - 2026-03-14\n\n### Fixed\n\n- **Per-model context window sizes**: Dashboard context gauge now shows correct utilization for Claude Opus 4.6 (1M context) and other models with non-200K windows\n\n### Changed\n\n- **Shared model context lookup**: CLI dashboard now uses the centralized `getModelContextWindowSize()` from `sidekick-shared` instead of a local duplicate map\n\n## [0.14.0] - 2026-03-12\n\n### Added\n\n- **`sidekick account` Command**: Manage Claude Code accounts from the terminal \u2014 list saved accounts, add the current account with an optional label, switch to the next or a specific account, and remove accounts. Supports `--json` output for scripting\n- **Quota Account Label**: `sidekick quota` now shows the active account email and label above the quota bars when multi-account is enabled\n- **macOS Keychain Support**: `sidekick account` and `sidekick quota` now read and write credentials via the system Keychain on macOS, fixing account switching and quota checks on Mac\n\n## [0.13.8] - 2026-03-12\n\n### Changed\n\n- **Structured quota failure output**: `sidekick quota` now renders consistent auth, rate-limit, server, network, and unexpected-failure copy from shared quota failure descriptors while preserving `--json` machine-readable output\n- **Dashboard unavailable quota rendering**: The Sessions panel now shows Claude Code quota failures inline instead of hiding the quota section whenever subscription data is unavailable\n- **Quota transition toasts**: The Ink dashboard now fires low-noise toast notifications only when Claude Code quota failure state changes, avoiding repeated alerts every polling interval\n\n## [0.13.7] - 2026-03-11\n\n### Changed\n\n- **npm README sync**: Updated the published CLI package README to reflect current OpenCode monitoring behavior, platform-specific data directories, and the `sqlite3` runtime requirement\n- **README badge cleanup**: Removed the Ask DeepWiki badge from the published CLI package README; the repo root README still keeps it\n\n## [0.13.6] - 2026-03-11\n\n### Changed\n\n- **Refreshed CLI Dashboard Wordmark**: Updated the dashboard wordmark/header styling for a cleaner splash and dashboard identity\n\n### Fixed\n\n- **OpenCode dashboard startup**: OpenCode DB-backed session discovery now resolves projects by worktree, sandboxes, and session directory instead of quietly behaving like no session exists\n- **OpenCode runtime notices**: The CLI now prints an OpenCode-only actionable notice when `opencode.db` exists but `sqlite3` is missing, blocked, or otherwise unusable in the current shell environment\n\n## [0.13.5] - 2026-03-10\n\n### Added\n\n- **`sidekick status` Command**: One-shot Claude API status check with color-coded text output and `--json` mode\n- **Dashboard Status Banner**: Status bar shows a colored `\u25CF API minor/major/critical` indicator when Claude is degraded; Sessions panel Summary tab shows an "API Status" section with affected components and active incident details. Polls every 60s\n\n## [0.13.4] - 2026-03-08\n\n### Fixed\n\n- **Onboarding Phrase Spam**: Splash screen and detail pane motivational phrases memoized \u2014 no longer flicker every render tick (fixes [#13](https://github.com/cesarandreslopez/sidekick-agent-hub/issues/13))\n\n### Changed\n\n- **Simplified Logo**: Replaced 6-line ASCII robot art with compact text header in splash, help, and changelog overlays\n- **Removed Dead Code**: Removed unused `getSplashContent()` and `HELP_HEADER` exports from branding module\n\n## [0.13.3] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.2] - 2026-03-04\n\n_No CLI-specific changes in this release._\n\n## [0.13.1] - 2026-03-04\n\n### Added\n\n- **`sidekick quota` Command**: One-shot subscription quota check showing 5-hour and 7-day utilization with color-coded progress bars and reset countdowns \u2014 supports `--json` for machine-readable output\n- **Quota Projections**: Elapsed-time projections shown in `sidekick quota` output and TUI dashboard quota section \u2014 displays projected end-of-window utilization next to current value (e.g., `40% \u2192 100%`), included in `--json` output as `projectedFiveHour` / `projectedSevenDay`\n\n## [0.13.0] - 2026-03-03\n\n_No CLI-specific changes in this release._\n\n## [0.12.10] - 2026-03-01\n\n### Added\n\n- **Events Panel** (key 7): Scrollable live event stream with colored type badges (`[USR]`, `[AST]`, `[TOOL]`, `[RES]`), timestamps, and keyword-highlighted summaries; detail tabs for full event JSON and surrounding context\n- **Charts Panel** (key 8): Tool frequency horizontal bars, event type distribution, 60-minute activity heatmap using `\u2591\u2592\u2593\u2588` intensity characters, and pattern analysis with frequency bars and template text\n- **Multi-Mode Filter**: `/` filter overlay now supports four modes \u2014 substring, fuzzy, regex, and date range \u2014 Tab cycles modes, regex mode shows red validation errors\n- **Search Term Highlighting**: Active filter terms highlighted in blue within side list items\n- **Timeline Keyword Coloring**: Event summaries in the Sessions panel Timeline tab now use semantic keyword coloring \u2014 errors red, success green, tool names cyan, file paths magenta\n\n### Removed\n\n- **Search Panel**: Removed redundant Search panel (previously key 7) \u2014 the `/` filter with multi-mode support serves the same purpose\n\n## [0.12.9] - 2026-02-28\n\n### Added\n\n- **Standalone Data Commands**: `sidekick tasks`, `sidekick decisions`, `sidekick notes`, `sidekick stats`, `sidekick handoff` for accessing project data without launching the TUI\n- **`sidekick search <query>`**: Cross-session full-text search from the terminal\n- **`sidekick context`**: Composite output of tasks, decisions, notes, and handoff for piping into other tools\n- **`--list` flag on `sidekick dump`**: Discover available session IDs before requiring `--session <id>`\n- **Search Panel**: Search panel (panel 7) wired into the TUI dashboard\n\n### Changed\n\n- **`taskMerger` utility**: Duplicate `mergeTasks` logic extracted into shared `taskMerger` utility\n- **Model constants**: Hardcoded model IDs extracted to named constants\n\n### Fixed\n\n- **`convention` icon**: Notes panel icon replaced with valid `tip` type\n- **Linux clipboard**: Now supports Wayland (`wl-copy`) and `xsel` fallbacks, with error messages instead of silent failure\n- **`provider.dispose()`**: Added to `dump` and `report` commands (prevents SQLite connection leaks)\n\n## [0.12.8] - 2026-02-28\n\n### Changed\n\n- **Dashboard UI/UX Polish**: Visual overhaul for better hierarchy, consistency, and readability\n  - Splash screen and help overlay now display the robot ASCII logo\n  - Toast notifications show severity icons (\u2718 error, \u26A0 warning, \u25CF info) with inner padding\n  - Focused pane uses double-border for clear focus indication\n  - Section dividers (`\u2500\u2500 Title \u2500\u2500\u2500\u2500`) replace bare bold headers in summary, agents, and context attribution\n  - Tab bar: active tab underlined in magenta, inactive tabs dimmed, bracket syntax removed\n  - Status bar: segmented layout with `\u2502` separators; keys bold, labels dim\n  - Summary metrics condensed: elapsed/events/compactions on one line, tokens on one line with cache rate and cost\n  - Sparklines display peak metadata annotations\n  - Progress bars use blessed color tags for consistent coloring\n  - Help overlay uses dot-leader alignment for all keybinding rows\n  - Empty state hints per panel (e.g. "Tasks appear as your agent works.")\n  - Session picker groups sessions by provider with section headers when multiple providers are present\n\n## [0.12.7] - 2026-02-27\n\n### Added\n\n- **HTML Session Report**: `sidekick report` command generates a self-contained HTML report and opens it in the default browser\n  - Options: `--session`, `--output`, `--theme` (dark/light), `--no-open`, `--no-thinking`\n  - TUI Dashboard: press `r` to generate and open an HTML report for the current session\n\n## [0.12.6] - 2026-02-26\n\n### Added\n\n- **Session Dump Command**: `sidekick dump` exports session data in text, markdown, or JSON format with `--format`, `--width`, and `--expand` options\n- **Plans Panel Re-enabled**: Plans panel restored in CLI dashboard with plan file discovery from `~/.claude/plans/`\n- **Enhanced Status Bar**: Session info display improved with richer metadata\n\n### Fixed\n\n- **Old snapshot format migration**: Restoring pre-0.12.3 session snapshots no longer shows empty timeline entries\n\n### Changed\n\n- **Phrase library moved to shared**: CLI-specific phrase formatting kept local, all phrase content now from `sidekick-shared`\n\n## [0.12.5] - 2026-02-24\n\n### Fixed\n\n- **Update check too slow to notice new versions**: Reduced npm registry cache TTL from 24 hours to 4 hours so upgrade notices appear sooner after a new release\n\n## [0.12.4] - 2026-02-24\n\n### Fixed\n\n- **Session crash on upgrade**: Fixed `d.timestamp.getTime is not a function` error when restoring tool call data from session snapshots \u2014 `Date` objects were serialized to strings by JSON but not rehydrated on restore, causing the session monitor to crash on first run after upgrading from 0.12.2 to 0.12.3\n\n## [0.12.3] - 2026-02-24\n\n### Added\n\n- **Latest-node indicator**: The most recently added node in tree and boxed mind map views is now marked with a yellow indicator\n- **Plan analytics in mind map**: Tree and boxed views now display plan progress and per-step metrics\n  - Tree view: plan header shows completion stats; steps show complexity, duration, tokens, tool calls, and errors in metadata brackets\n  - Box view: progress bar with completion percentage; steps show right-aligned metrics; subtitle shows step count and total duration\n- **Cross-provider plan extraction**: Shared `PlanExtractor` now handles Claude Code (EnterPlanMode/ExitPlanMode) and OpenCode (`<proposed_plan>` XML) plans \u2014 previously only Codex plans were shown\n- **Enriched plan data model**: Plan steps include duration, token count, tool call count, and error messages\n- **Phase-grouped plan display**: When a plan has phase structure, tree and boxed views group steps under phase headers with context lines from the original plan markdown\n- **Node type filter**: Press `f` on the Mind Map tab to cycle through node type filters (file, tool, task, subagent, command, plan, knowledge-note) \u2014 non-matching sections render dimmed in grey\n\n### Fixed\n\n- **Kanban board regression**: Subagent and plan-step tasks now correctly appear in the kanban board\n\n### Changed\n\n- **Plans panel temporarily disabled**: The Plans panel in the CLI dashboard is disabled until plan-mode event capture is reliably working end-to-end. Plan nodes in the mind map remain active.\n- `DashboardState` now delegates to shared `EventAggregator` instead of maintaining its own aggregation logic\n\n## [0.12.2] - 2026-02-23\n\n### Added\n\n- **Update notifications**: The dashboard now checks the npm registry for newer versions on startup and shows a yellow banner in the status bar when an update is available (e.g., `v0.13.0 available \u2014 npm i -g sidekick-agent-hub`). Results are cached for 24 hours to avoid repeated network requests.\n\n## [0.12.1] - 2026-02-23\n\n### Fixed\n\n- **VS Code integration**: Fixed exit code 127 when the extension launches the CLI dashboard on systems using nvm or volta (node binary not found when shell init is bypassed)\n\n## [0.12.0] - 2026-02-22\n\n### Added\n\n- **"Open CLI Dashboard" VS Code Integration**: New VS Code command `Sidekick: Open CLI Dashboard` launches the TUI dashboard in an integrated terminal\n  - Install the CLI with `npm install -g sidekick-agent-hub`\n\n## [0.11.0] - 2026-02-19\n\n### Added\n\n- **Initial Release**: Full-screen TUI dashboard for monitoring agent sessions from the terminal\n  - Ink-based terminal UI with panels for sessions, tasks, kanban, mind map, notes, decisions, search, files, and git diff\n  - Multi-provider support: auto-detects Claude Code, OpenCode, and Codex sessions\n  - Reads from `~/.config/sidekick/` \u2014 the same data files the VS Code extension writes\n  - Usage: `sidekick dashboard [--project <path>] [--provider <id>]`\n';
   }
 });
 
@@ -82316,7 +82784,7 @@ async function quotaAction(_opts, cmd) {
     return;
   }
   if (provider.id === "codex") {
-    await codexQuotaAction(provider, globalOpts, jsonOutput);
+    await codexQuotaAction(provider, globalOpts, localOpts, jsonOutput);
     return;
   }
   provider.dispose();
@@ -82387,57 +82855,25 @@ function printPeakHoursSummary(peak) {
   process.stdout.write(`  ${source_default.dim("Peak")}     ${line}
 `);
 }
-async function codexQuotaAction(provider, globalOpts, jsonOutput) {
+async function codexQuotaAction(provider, globalOpts, localOpts, jsonOutput) {
   const workspacePath = globalOpts.project || process.cwd();
   const activeAccount = (0, import_sidekick_shared29.getActiveCodexAccount)();
-  let quota = activeAccount ? (0, import_sidekick_shared29.readQuotaSnapshot)("codex", activeAccount.id) : null;
-  const sessions = provider.findAllSessions(workspacePath);
-  if (sessions.length > 0) {
-    const captured = { rl: void 0 };
-    try {
-      const result = (0, import_sidekick_shared29.createWatcher)({
-        provider,
-        workspacePath,
-        callbacks: {
-          onEvent: (event) => {
-            if (event.rateLimits) {
-              captured.rl = event.rateLimits;
-            }
-          },
-          onError: () => {
-          }
-        }
-      });
-      result.watcher.start(true);
-      result.watcher.stop();
-    } catch {
-    }
-    const liveQuota = captured.rl ? (0, import_sidekick_shared29.quotaFromCodexRateLimits)({
-      primary: captured.rl.primary ? {
-        used_percent: captured.rl.primary.usedPercent,
-        window_minutes: captured.rl.primary.windowMinutes,
-        resets_at: captured.rl.primary.resetsAt
-      } : void 0,
-      secondary: captured.rl.secondary ? {
-        used_percent: captured.rl.secondary.usedPercent,
-        window_minutes: captured.rl.secondary.windowMinutes,
-        resets_at: captured.rl.secondary.resetsAt
-      } : void 0
-    }, "session") : null;
-    if (liveQuota) {
-      quota = liveQuota;
-      if (activeAccount) {
-        (0, import_sidekick_shared29.writeQuotaSnapshot)("codex", activeAccount.id, liveQuota);
-      }
-    }
+  let quota;
+  try {
+    quota = await (0, import_sidekick_shared29.resolveCodexQuota)({
+      workspacePath,
+      provider,
+      activeAccount,
+      source: localOpts.refresh ? "api" : "local"
+    });
+  } finally {
+    provider.dispose();
   }
-  provider.dispose();
-  if (!quota) {
-    const msg = activeAccount ? `No active Codex session and no cached rate-limit snapshot is available for "${activeAccount.label ?? activeAccount.id}".` : "No active Codex session and no saved Codex account snapshot is available.";
+  if (!quota.available) {
     if (jsonOutput) {
-      process.stdout.write(JSON.stringify({ available: false, error: msg }, null, 2) + "\n");
+      process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
     } else {
-      process.stderr.write(source_default.yellow(msg) + "\n");
+      process.stderr.write(source_default.yellow(quota.error ?? "Codex rate-limit data is unavailable.") + "\n");
     }
     return;
   }
@@ -82989,7 +83425,7 @@ var init_cli = __esm({
     defaultAccountsReady = (0, import_sidekick_shared34.ensureDefaultAccounts)().catch(() => {
     });
     program2 = new Command();
-    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.18.1").option("--json", "Output as JSON").option("--project <path>", "Override project path (default: cwd)").option("--provider <id>", "Provider: claude-code, opencode, codex, auto (default: auto)");
+    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.18.2").option("--json", "Output as JSON").option("--project <path>", "Override project path (default: cwd)").option("--provider <id>", "Provider: claude-code, opencode, codex, auto (default: auto)");
     program2.hook("preAction", async () => {
       await defaultAccountsReady;
     });
@@ -83039,7 +83475,7 @@ var init_cli = __esm({
       return statsAction2(_opts, cmd);
     });
     program2.addCommand(statsCmd);
-    quotaCmd = new Command("quota").description("Show quota or rate-limit utilization (auto-detects provider)").option("--provider <id>", "Provider: claude-code, codex, auto (default: auto)").action(async (_opts, cmd) => {
+    quotaCmd = new Command("quota").description("Show quota or rate-limit utilization (auto-detects provider)").option("--provider <id>", "Provider: claude-code, codex, auto (default: auto)").option("--refresh", "For Codex, explicitly refresh from the Codex usage API before falling back to local data").action(async (_opts, cmd) => {
       const { quotaAction: quotaAction2 } = await Promise.resolve().then(() => (init_quota(), quota_exports));
       return quotaAction2(_opts, cmd);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sidekick-agent-hub",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "description": "Terminal dashboard for monitoring AI coding agent sessions",
   "type": "module",
   "bin": {