sidekick-agent-hub 0.12.10 → 0.13.1

package/README.md

@@ -27,7 +27,7 @@ Requires **Node.js 20+**.
 
 ```bash
 sidekick dashboard [options]
-sidekick tasks|decisions|notes|stats|handoff|search|context [options]
+sidekick tasks|decisions|notes|stats|quota|handoff|search|context [options]
 ```
 
 The standalone commands open the dashboard directly to a specific panel or run a one-shot query. All accept `--project` and `--provider` flags.
@@ -77,6 +77,23 @@ Global flags `--project` and `--provider` also apply.
 
 You can also press `r` in the TUI dashboard to generate a report for the current session.
 
+## Subscription Quota
+
+```bash
+sidekick quota
+```
+
+Check Claude Max / Claude Code subscription quota utilization. Shows 5-hour and 7-day windows with color-coded progress bars and reset countdowns.
+
+```
+Subscription Quota
+──────────────────────────────────────────────────
+  5-Hour   ████████████░░░░░░░░░░░░░░░░░░ 40%   resets in 2h 15m
+  7-Day    ██████████████████████░░░░░░░░ 72%   resets in 4d 6h
+```
+
+Use `--json` for machine-readable output. Requires Claude Code credentials (`~/.claude/.credentials.json`).
+
 ## Dashboard Panels
 
 The dashboard is a two-pane terminal UI. The left side shows a navigable list, the right side shows details for the selected item.

package/dist/sidekick-cli.mjs

@@ -8251,8 +8251,6 @@ var require_codexDatabase = __commonJS({
       }
       isAvailable() {
         try {
-          if (!fs10.existsSync(this.dbPath))
-            return false;
           return fs10.statSync(this.dbPath).size > 0;
         } catch {
           return false;
@@ -8275,15 +8273,19 @@ var require_codexDatabase = __commonJS({
       query(sql, params = []) {
         if (!this.sqlite3Available)
           return [];
-        let query = sql;
-        for (const param of params) {
-          if (typeof param === "number")
-            query = query.replace("?", String(param));
-          else {
-            const escaped = String(param).replace(/'/g, "''");
-            query = query.replace("?", `'${escaped}'`);
-          }
-        }
+        let paramIndex = 0;
+        const query = sql.replace(/\?/g, () => {
+          if (paramIndex >= params.length)
+            return "?";
+          const param = params[paramIndex++];
+          if (typeof param === "number") {
+            if (!Number.isFinite(param))
+              return "0";
+            return String(param);
+          }
+          const escaped = String(param).replace(/'/g, "''");
+          return `'${escaped}'`;
+        });
         try {
           const result = (0, child_process_1.execFileSync)("sqlite3", ["-json", "-readonly", this.dbPath, query], {
             encoding: "utf-8",
@@ -18746,19 +18748,18 @@ var init_StaticDataLoader = __esm({
 import * as fs2 from "fs";
 import * as path from "path";
 import * as os from "os";
-var REFRESH_MS, USAGE_URL, BETA_HEADER, MAX_HISTORY, QuotaService;
+var REFRESH_MS, USAGE_URL, BETA_HEADER, FIVE_HOUR_MS, SEVEN_DAY_MS, QuotaService;
 var init_QuotaService = __esm({
   "src/dashboard/QuotaService.ts"() {
     "use strict";
     REFRESH_MS = 3e4;
     USAGE_URL = "https://api.anthropic.com/api/oauth/usage";
     BETA_HEADER = "oauth-2025-04-20";
-    MAX_HISTORY = 10;
+    FIVE_HOUR_MS = 5 * 36e5;
+    SEVEN_DAY_MS = 7 * 864e5;
     QuotaService = class {
       _interval = null;
       _cached = null;
-      _fiveHourHistory = [];
-      _sevenDayHistory = [];
       _callback = null;
       /** Register a callback for quota updates. */
       onUpdate(cb) {
@@ -18781,6 +18782,41 @@ var init_QuotaService = __esm({
       getCached() {
         return this._cached;
       }
+      /** Single fetch — no polling, includes elapsed-time projections. */
+      async fetchOnce() {
+        const token = await this.readToken();
+        if (!token) {
+          return { fiveHour: { utilization: 0, resetsAt: "" }, sevenDay: { utilization: 0, resetsAt: "" }, available: false, error: "no-credentials" };
+        }
+        try {
+          const res = await fetch(USAGE_URL, {
+            method: "GET",
+            headers: {
+              "Authorization": `Bearer ${token}`,
+              "anthropic-beta": BETA_HEADER,
+              "Content-Type": "application/json"
+            }
+          });
+          if (!res.ok) {
+            const error = res.status === 401 ? "auth-failed" : `API error: ${res.status}`;
+            return { fiveHour: { utilization: 0, resetsAt: "" }, sevenDay: { utilization: 0, resetsAt: "" }, available: false, error };
+          }
+          const data = await res.json();
+          const fiveUtil = data.five_hour?.utilization ?? 0;
+          const sevenUtil = data.seven_day?.utilization ?? 0;
+          const fiveResetsAt = data.five_hour?.resets_at ?? "";
+          const sevenResetsAt = data.seven_day?.resets_at ?? "";
+          return {
+            fiveHour: { utilization: fiveUtil, resetsAt: fiveResetsAt },
+            sevenDay: { utilization: sevenUtil, resetsAt: sevenResetsAt },
+            available: true,
+            projectedFiveHour: this.projectFromElapsed(fiveUtil, fiveResetsAt, FIVE_HOUR_MS),
+            projectedSevenDay: this.projectFromElapsed(sevenUtil, sevenResetsAt, SEVEN_DAY_MS)
+          };
+        } catch {
+          return { fiveHour: { utilization: 0, resetsAt: "" }, sevenDay: { utilization: 0, resetsAt: "" }, available: false, error: "network-error" };
+        }
+      }
       async fetchQuota() {
         const token = await this.readToken();
         if (!token) {
@@ -18809,16 +18845,14 @@ var init_QuotaService = __esm({
           const data = await res.json();
           const fiveUtil = data.five_hour?.utilization ?? 0;
           const sevenUtil = data.seven_day?.utilization ?? 0;
-          this.addHistory(this._fiveHourHistory, fiveUtil);
-          this.addHistory(this._sevenDayHistory, sevenUtil);
           const fiveResetsAt = data.five_hour?.resets_at ?? "";
           const sevenResetsAt = data.seven_day?.resets_at ?? "";
           this.emit({
             fiveHour: { utilization: fiveUtil, resetsAt: fiveResetsAt },
             sevenDay: { utilization: sevenUtil, resetsAt: sevenResetsAt },
             available: true,
-            projectedFiveHour: this.project(fiveUtil, fiveResetsAt, this.rate(this._fiveHourHistory)),
-            projectedSevenDay: this.project(sevenUtil, sevenResetsAt, this.rate(this._sevenDayHistory))
+            projectedFiveHour: this.projectFromElapsed(fiveUtil, fiveResetsAt, FIVE_HOUR_MS),
+            projectedSevenDay: this.projectFromElapsed(sevenUtil, sevenResetsAt, SEVEN_DAY_MS)
           });
         } catch {
           if (this._cached?.available) return;
@@ -18843,25 +18877,13 @@ var init_QuotaService = __esm({
           return null;
         }
       }
-      addHistory(history, utilization) {
-        history.push({ utilization, timestamp: Date.now() });
-        while (history.length > MAX_HISTORY) history.shift();
-      }
-      rate(history) {
-        if (history.length < 2) return null;
-        const oldest = history[0];
-        const newest = history[history.length - 1];
-        const diffMs = newest.timestamp - oldest.timestamp;
-        if (diffMs < 3e4) return null;
-        const diffUtil = newest.utilization - oldest.utilization;
-        if (diffUtil <= 0) return 0;
-        return diffUtil / (diffMs / 6e4);
-      }
-      project(current, resetsAt, rate) {
-        if (rate === null || rate <= 0 || !resetsAt) return void 0;
-        const timeToResetMs = new Date(resetsAt).getTime() - Date.now();
-        if (timeToResetMs <= 0) return void 0;
-        return Math.min(current + rate * (timeToResetMs / 6e4), 200);
+      projectFromElapsed(utilization, resetsAt, windowMs) {
+        if (!resetsAt || utilization <= 0) return void 0;
+        const resetTime = new Date(resetsAt).getTime();
+        const now = Date.now();
+        const elapsed = windowMs - (resetTime - now);
+        if (elapsed <= 0) return void 0;
+        return Math.min(Math.round(utilization * (windowMs / elapsed)), 200);
       }
     };
   }
@@ -18898,7 +18920,7 @@ var init_UpdateCheckService = __esm({
       /** Run the update check (one-shot). */
       async check() {
         try {
-          const current = "0.12.10";
+          const current = "0.13.1";
           const cached = this.readCache();
           let latest;
           if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
@@ -20469,10 +20491,18 @@ ${hint}{/grey-fg}`;
             lines.push("", sectionHeader("Quota", w2));
             const fiveColor = getUtilizationColor(q.fiveHour.utilization);
             const fiveBar = makeColorBar(q.fiveHour.utilization, 18, fiveColor);
-            lines.push(`  {grey-fg}5h{/grey-fg}  ${fiveBar} {bold}${q.fiveHour.utilization.toFixed(0)}%{/bold}`);
+            const fiveProj = q.projectedFiveHour != null ? (() => {
+              const pc = getUtilizationColor(q.projectedFiveHour);
+              return ` {grey-fg}\u2192{/grey-fg} {${pc}-fg}${q.projectedFiveHour.toFixed(0)}%{/${pc}-fg}`;
+            })() : "";
+            lines.push(`  {grey-fg}5h{/grey-fg}  ${fiveBar} {bold}${q.fiveHour.utilization.toFixed(0)}%{/bold}${fiveProj}`);
             const sevenColor = getUtilizationColor(q.sevenDay.utilization);
             const sevenBar = makeColorBar(q.sevenDay.utilization, 18, sevenColor);
-            lines.push(`  {grey-fg}7d{/grey-fg}  ${sevenBar} {bold}${q.sevenDay.utilization.toFixed(0)}%{/bold}`);
+            const sevenProj = q.projectedSevenDay != null ? (() => {
+              const pc = getUtilizationColor(q.projectedSevenDay);
+              return ` {grey-fg}\u2192{/grey-fg} {${pc}-fg}${q.projectedSevenDay.toFixed(0)}%{/${pc}-fg}`;
+            })() : "";
+            lines.push(`  {grey-fg}7d{/grey-fg}  ${sevenBar} {bold}${q.sevenDay.utilization.toFixed(0)}%{/bold}${sevenProj}`);
           }
           const attrLines = renderContextAttribution(m.contextAttribution);
           if (attrLines.length > 0) {
@@ -59446,7 +59476,7 @@ function StatusBar({
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { dimColor: true, children: [
         " v",
-        "0.12.10"
+        "0.13.1"
       ] }),
       updateInfo && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { color: "yellow", children: [
         " (v",
@@ -59829,7 +59859,7 @@ function ChangelogOverlay({ entries, scrollOffset }) {
       "  ",
       /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { bold: true, color: "cyan", children: [
         "Terminal Dashboard v",
-        "0.12.10"
+        "0.13.1"
       ] }),
       latestDate ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { color: "gray", children: [
         " \u2014 ",
@@ -60184,7 +60214,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.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.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';
   }
 });
 
@@ -62183,6 +62213,92 @@ var init_stats = __esm({
   }
 });
 
+// src/commands/quota.ts
+var quota_exports = {};
+__export(quota_exports, {
+  formatTimeUntil: () => formatTimeUntil,
+  getUtilizationColor: () => getUtilizationColor2,
+  makeChalkBar: () => makeChalkBar,
+  quotaAction: () => quotaAction
+});
+function getUtilizationColor2(percent) {
+  if (percent < 60) return source_default.green;
+  if (percent < 80) return source_default.yellow;
+  return source_default.red;
+}
+function makeChalkBar(percent, width) {
+  const filled = Math.round(percent / 100 * width);
+  const empty = width - filled;
+  const color = getUtilizationColor2(percent);
+  return color("\u2588".repeat(filled)) + source_default.dim("\u2591".repeat(empty));
+}
+function formatTimeUntil(isoString) {
+  if (!isoString) return "";
+  const ms = new Date(isoString).getTime() - Date.now();
+  if (ms <= 0) return "now";
+  const totalMinutes = Math.floor(ms / 6e4);
+  const days = Math.floor(totalMinutes / 1440);
+  const hours = Math.floor(totalMinutes % 1440 / 60);
+  const minutes = totalMinutes % 60;
+  const parts = [];
+  if (days > 0) parts.push(`${days}d`);
+  if (hours > 0) parts.push(`${hours}h`);
+  if (minutes > 0 && days === 0) parts.push(`${minutes}m`);
+  return "in " + (parts.join(" ") || "0m");
+}
+async function quotaAction(_opts, cmd) {
+  const globalOpts = cmd.parent.opts();
+  const jsonOutput = !!globalOpts.json;
+  const service = new QuotaService();
+  const quota = await service.fetchOnce();
+  if (!quota.available) {
+    if (jsonOutput) {
+      process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
+      return;
+    }
+    let msg;
+    switch (quota.error) {
+      case "no-credentials":
+        msg = "No Claude Code credentials found. Sign in with `claude` first.";
+        break;
+      case "auth-failed":
+        msg = "Authentication failed. Try signing in to Claude Code again.";
+        break;
+      case "network-error":
+        msg = "Could not reach the Anthropic API. Check your connection.";
+        break;
+      default:
+        msg = quota.error ?? "Unknown error fetching quota.";
+    }
+    process.stderr.write(source_default.red(msg) + "\n");
+    process.exit(1);
+  }
+  if (jsonOutput) {
+    process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
+    return;
+  }
+  const barWidth = 30;
+  const fivePct = Math.round(quota.fiveHour.utilization);
+  const sevenPct = Math.round(quota.sevenDay.utilization);
+  const fiveReset = formatTimeUntil(quota.fiveHour.resetsAt);
+  const sevenReset = formatTimeUntil(quota.sevenDay.resetsAt);
+  const fiveProj = quota.projectedFiveHour != null ? ` ${source_default.dim("\u2192")} ${getUtilizationColor2(quota.projectedFiveHour)(String(Math.round(quota.projectedFiveHour)).padStart(3) + "%")}` : "";
+  const sevenProj = quota.projectedSevenDay != null ? ` ${source_default.dim("\u2192")} ${getUtilizationColor2(quota.projectedSevenDay)(String(Math.round(quota.projectedSevenDay)).padStart(3) + "%")}` : "";
+  process.stdout.write(source_default.bold("Subscription Quota\n"));
+  process.stdout.write(source_default.dim("\u2500".repeat(50) + "\n"));
+  process.stdout.write(`  ${source_default.dim("5-Hour")}   ${makeChalkBar(fivePct, barWidth)} ${String(fivePct).padStart(3)}%${fiveProj}   ${source_default.dim("resets " + fiveReset)}
+`);
+  process.stdout.write(`  ${source_default.dim("7-Day")}    ${makeChalkBar(sevenPct, barWidth)} ${String(sevenPct).padStart(3)}%${sevenProj}   ${source_default.dim("resets " + sevenReset)}
+`);
+}
+var init_quota = __esm({
+  "src/commands/quota.ts"() {
+    "use strict";
+    init_source();
+    init_QuotaService();
+  }
+});
+
 // src/commands/handoff.ts
 var handoff_exports = {};
 __export(handoff_exports, {
@@ -62246,14 +62362,14 @@ function resolveProvider(opts) {
       return new import_sidekick_shared23.ClaudeCodeProvider();
   }
 }
-var import_sidekick_shared22, import_sidekick_shared23, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, handoffCmd;
+var import_sidekick_shared22, import_sidekick_shared23, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, quotaCmd, handoffCmd;
 var init_cli = __esm({
   "src/cli.ts"() {
     init_esm();
     import_sidekick_shared22 = __toESM(require_dist(), 1);
     import_sidekick_shared23 = __toESM(require_dist(), 1);
     program2 = new Command();
-    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.12.10").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.13.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)");
     dashCmd = new Command("dashboard").description("Full-screen TUI dashboard with live session metrics").option("--session <id>", "Follow a specific session (default: most recent)").option("--replay", "Replay existing events before streaming new ones").action(async (_opts, cmd) => {
       const { dashboardAction: dashboardAction2 } = await init_dashboard().then(() => dashboard_exports);
       return dashboardAction2(_opts, cmd);
@@ -62300,6 +62416,11 @@ var init_cli = __esm({
       return statsAction2(_opts, cmd);
     });
     program2.addCommand(statsCmd);
+    quotaCmd = new Command("quota").description("Show subscription quota utilization (Claude Max / Claude Code)").action(async (_opts, cmd) => {
+      const { quotaAction: quotaAction2 } = await Promise.resolve().then(() => (init_quota(), quota_exports));
+      return quotaAction2(_opts, cmd);
+    });
+    program2.addCommand(quotaCmd);
     handoffCmd = new Command("handoff").description("Show the latest session handoff document for the current project").action(async (_opts, cmd) => {
       const { handoffAction: handoffAction2 } = await Promise.resolve().then(() => (init_handoff(), handoff_exports));
       return handoffAction2(_opts, cmd);

package/package.json

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