sidekick-agent-hub 0.17.5 → 0.17.6

package/README.md

@@ -95,6 +95,16 @@ sidekick status
 
 Check API health for both Claude (status.claude.com) and OpenAI (status.openai.com). Shows indicators with color coding (green/yellow/red), affected components, and active incident details. Use `--json` for machine-readable output. In the dashboard, provider-status surfaces are scoped to the monitored provider: Claude for Claude Code sessions, OpenAI for Codex sessions, and hidden for OpenCode.
 
+When the active provider is `claude-code`, the output also includes a **Claude Peak Hours** block (see below).
+
+## Peak Hours
+
+```bash
+sidekick peak
+```
+
+Show whether Claude is currently in peak hours (weekdays 13:00–19:00 UTC — when session limits drain faster on Free/Pro/Max/Team subscriptions). Data comes from the public `promoclock.co/api/status` endpoint (third-party, unaffiliated with Anthropic). Use `--json` for machine-readable output. The peak-hours summary also appears under the bars in `sidekick quota` for Claude subscriptions.
+
 ## Quota & Rate Limits
 
 ```bash
@@ -103,7 +113,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.
+- **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.
 - **OpenCode**: Prints an informational message (no rate-limit data available).
 

package/dist/sidekick-cli.mjs

@@ -34929,6 +34929,65 @@ var require_providerStatus = __commonJS({
   }
 });
 
+// ../sidekick-shared/dist/peakHours.js
+var require_peakHours = __commonJS({
+  "../sidekick-shared/dist/peakHours.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.fetchPeakHoursStatus = fetchPeakHoursStatus4;
+    var PROMOCLOCK_ENDPOINT = "https://promoclock.co/api/status";
+    function unavailableState() {
+      return {
+        status: "unknown",
+        isPeak: false,
+        sessionLimitSpeed: "unknown",
+        label: "Peak-hours status unavailable",
+        peakHoursDescription: "",
+        nextChange: null,
+        minutesUntilChange: null,
+        note: "",
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        unavailable: true
+      };
+    }
+    function normalizeStatus(raw) {
+      if (raw === "peak" || raw === "off_peak")
+        return raw;
+      return "unknown";
+    }
+    function normalizeSpeed(raw) {
+      if (raw === "normal" || raw === "faster")
+        return raw;
+      return "unknown";
+    }
+    async function fetchPeakHoursStatus4() {
+      try {
+        const res = await fetch(PROMOCLOCK_ENDPOINT);
+        if (!res.ok)
+          return unavailableState();
+        const data = await res.json();
+        const status = normalizeStatus(data.status);
+        const sessionLimitSpeed = normalizeSpeed(data.sessionLimitSpeed);
+        const isPeak = typeof data.isPeak === "boolean" ? data.isPeak : status === "peak";
+        return {
+          status,
+          isPeak,
+          sessionLimitSpeed,
+          label: data.label ?? (isPeak ? "Peak Hours" : "Off-Peak"),
+          peakHoursDescription: data.peakHours ?? "",
+          nextChange: data.nextChange ?? null,
+          minutesUntilChange: typeof data.minutesUntilChange === "number" ? data.minutesUntilChange : null,
+          note: data.note ?? "",
+          updatedAt: data.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+          unavailable: false
+        };
+      } catch {
+        return unavailableState();
+      }
+    }
+  }
+});
+
 // ../sidekick-shared/dist/index.js
 var require_dist = __commonJS({
   "../sidekick-shared/dist/index.js"(exports) {
@@ -34937,7 +34996,7 @@ var require_dist = __commonJS({
     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.HeatmapTracker = exports.FrequencyTracker = exports.getSnapshotPath = exports.isSnapshotValid = exports.deleteSnapshot = exports.loadSnapshot = exports.saveSnapshot = exports.parseTodoDependencies = exports.EventAggregator = exports.getRandomPhrase = 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.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.getModelInfo = exports.getModelPricing = exports.parseModelId = exports.DEFAULT_CONTEXT_WINDOW = exports.getModelContextWindowSize = 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.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 = void 0;
-    exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.extractToolCalls = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.calculateCostWithPricing = exports.calculateCost = void 0;
+    exports.fetchPeakHoursStatus = exports.fetchOpenAIStatus = exports.fetchProviderStatus = exports.permissionModeSchema = exports.sessionEventSchema = exports.sessionMessageSchema = exports.messageUsageSchema = exports.extractToolCalls = exports.extractTokenUsage = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = exports.formatCost = exports.calculateCostWithPricing = exports.calculateCost = 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;
@@ -35492,6 +35551,10 @@ var require_dist = __commonJS({
     Object.defineProperty(exports, "fetchOpenAIStatus", { enumerable: true, get: function() {
       return providerStatus_1.fetchOpenAIStatus;
     } });
+    var peakHours_1 = require_peakHours();
+    Object.defineProperty(exports, "fetchPeakHoursStatus", { enumerable: true, get: function() {
+      return peakHours_1.fetchPeakHoursStatus;
+    } });
   }
 });
 
@@ -37727,7 +37790,7 @@ var init_UpdateCheckService = __esm({
       /** Run the update check (one-shot). */
       async check() {
         try {
-          const current = "0.17.5";
+          const current = "0.17.6";
           const cached = this.readCache();
           let latest;
           if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
@@ -78345,7 +78408,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.17.5"
+        "0.17.6"
       ] }),
       updateInfo && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Text, { color: "yellow", children: [
         " (v",
@@ -78735,7 +78798,7 @@ function ChangelogOverlay({ entries, scrollOffset }) {
       "  ",
       /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { bold: true, color: "cyan", children: [
         "Terminal Dashboard v",
-        "0.17.5"
+        "0.17.6"
       ] }),
       latestDate ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(Text, { color: "gray", children: [
         " \u2014 ",
@@ -79057,7 +79120,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.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.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';
   }
 });
 
@@ -81136,6 +81199,57 @@ var init_stats = __esm({
   }
 });
 
+// src/commands/peakHoursRender.ts
+function formatCountdown(minutes) {
+  if (typeof minutes !== "number" || minutes <= 0) return "";
+  const h = Math.floor(minutes / 60);
+  const m = minutes % 60;
+  return h > 0 ? `${h}h ${m}m` : `${m}m`;
+}
+function printPeakHoursBlock(state) {
+  process.stdout.write(source_default.bold("Claude Peak Hours\n"));
+  process.stdout.write(source_default.dim("\u2500".repeat(50) + "\n"));
+  if (state.unavailable) {
+    process.stdout.write(source_default.dim("  Peak-hours status unavailable (promoclock.co unreachable).\n"));
+    return;
+  }
+  const color = state.isPeak ? source_default.hex("#E59C4F") : source_default.green;
+  const dot = "\u25CF";
+  process.stdout.write(`  ${color(dot)} ${color(state.label || (state.isPeak ? "Peak" : "Off-Peak"))}
+`);
+  const countdown = formatCountdown(state.minutesUntilChange);
+  if (countdown) {
+    const label = state.isPeak ? "Off-peak in" : "Next peak in";
+    process.stdout.write(source_default.dim(`  ${label} ${countdown}
+`));
+  }
+  if (state.peakHoursDescription) {
+    process.stdout.write(source_default.dim(`  ${state.peakHoursDescription}
+`));
+  }
+  if (state.note) {
+    process.stdout.write(source_default.dim(`  ${state.note}
+`));
+  }
+  process.stdout.write(source_default.dim("  Source: promoclock.co (third-party, unaffiliated with Anthropic)\n"));
+}
+function formatPeakHoursLine(state) {
+  if (state.unavailable) return "";
+  const countdown = formatCountdown(state.minutesUntilChange);
+  if (state.isPeak) {
+    const suffix2 = countdown ? ` ${source_default.dim("(off-peak in " + countdown + ")")}` : "";
+    return `${source_default.hex("#E59C4F")("\u25CF")} ${source_default.hex("#E59C4F")(state.label || "Peak Hours \u2014 Faster Drain")}${suffix2}`;
+  }
+  const suffix = countdown ? ` ${source_default.dim("(peak in " + countdown + ")")}` : "";
+  return `${source_default.green("\u25CF")} ${source_default.green(state.label || "Off-Peak \u2014 Normal Speed")}${suffix}`;
+}
+var init_peakHoursRender = __esm({
+  "src/commands/peakHoursRender.ts"() {
+    "use strict";
+    init_source();
+  }
+});
+
 // src/commands/quota.ts
 var quota_exports = {};
 __export(quota_exports, {
@@ -81198,10 +81312,13 @@ async function quotaAction(_opts, cmd) {
 }
 async function claudeQuotaAction(jsonOutput) {
   const service = new QuotaService();
-  const quota = await service.fetchOnce();
+  const [quota, peak] = await Promise.all([
+    service.fetchOnce(),
+    (0, import_sidekick_shared28.fetchPeakHoursStatus)()
+  ]);
   if (!quota.available) {
     if (jsonOutput) {
-      process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
+      process.stdout.write(JSON.stringify({ ...quota, peak }, null, 2) + "\n");
       return;
     }
     const descriptor = (0, import_sidekick_shared28.describeQuotaFailure)(quota);
@@ -81229,7 +81346,7 @@ async function claudeQuotaAction(jsonOutput) {
     process.exit(1);
   }
   if (jsonOutput) {
-    process.stdout.write(JSON.stringify(quota, null, 2) + "\n");
+    process.stdout.write(JSON.stringify({ ...quota, peak }, null, 2) + "\n");
     return;
   }
   const barWidth = 30;
@@ -81249,6 +81366,13 @@ async function claudeQuotaAction(jsonOutput) {
   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)}
+`);
+  printPeakHoursSummary(peak);
+}
+function printPeakHoursSummary(peak) {
+  const line = formatPeakHoursLine(peak);
+  if (!line) return;
+  process.stdout.write(`  ${source_default.dim("Peak")}     ${line}
 `);
 }
 async function codexQuotaAction(provider, globalOpts, jsonOutput) {
@@ -81343,6 +81467,7 @@ var init_quota = __esm({
     import_sidekick_shared28 = __toESM(require_dist(), 1);
     init_cli();
     init_QuotaService();
+    init_peakHoursRender();
   }
 });
 
@@ -81389,17 +81514,24 @@ function printStatus(label, statusPageHost, status) {
 async function statusAction(_opts, cmd) {
   const globalOpts = cmd.parent.opts();
   const jsonOutput = !!globalOpts.json;
-  const [claude, openai] = await Promise.all([
+  const providerId = resolveProviderId(globalOpts);
+  const wantsPeak = providerId === "claude-code";
+  const [claude, openai, peak] = await Promise.all([
     (0, import_sidekick_shared29.fetchProviderStatus)(),
-    (0, import_sidekick_shared29.fetchOpenAIStatus)()
+    (0, import_sidekick_shared29.fetchOpenAIStatus)(),
+    wantsPeak ? (0, import_sidekick_shared29.fetchPeakHoursStatus)() : Promise.resolve(null)
   ]);
   if (jsonOutput) {
-    process.stdout.write(JSON.stringify({ claude, openai }, null, 2) + "\n");
+    process.stdout.write(JSON.stringify({ claude, openai, peak }, null, 2) + "\n");
     return;
   }
   printStatus("Claude API Status", "status.claude.com", claude);
   process.stdout.write("\n");
   printStatus("OpenAI API Status", "status.openai.com", openai);
+  if (peak) {
+    process.stdout.write("\n");
+    printPeakHoursBlock(peak);
+  }
 }
 var import_sidekick_shared29;
 var init_status = __esm({
@@ -81407,6 +81539,32 @@ var init_status = __esm({
     "use strict";
     init_source();
     import_sidekick_shared29 = __toESM(require_dist(), 1);
+    init_peakHoursRender();
+    init_cli();
+  }
+});
+
+// src/commands/peak.ts
+var peak_exports = {};
+__export(peak_exports, {
+  peakAction: () => peakAction
+});
+async function peakAction(_opts, cmd) {
+  const globalOpts = cmd.parent.opts();
+  const jsonOutput = !!globalOpts.json;
+  const state = await (0, import_sidekick_shared30.fetchPeakHoursStatus)();
+  if (jsonOutput) {
+    process.stdout.write(JSON.stringify(state, null, 2) + "\n");
+    return;
+  }
+  printPeakHoursBlock(state);
+}
+var import_sidekick_shared30;
+var init_peak = __esm({
+  "src/commands/peak.ts"() {
+    "use strict";
+    import_sidekick_shared30 = __toESM(require_dist(), 1);
+    init_peakHoursRender();
   }
 });
 
@@ -81437,13 +81595,13 @@ async function accountAction(_opts, cmd) {
 }
 function claudeAccountAction(opts, jsonOutput) {
   if (opts.add) {
-    const result = (0, import_sidekick_shared30.addCurrentAccount)(opts.label);
+    const result = (0, import_sidekick_shared31.addCurrentAccount)(opts.label);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to save account.") + "\n");
       process.exit(1);
       return;
     }
-    const active2 = (0, import_sidekick_shared30.readActiveClaudeAccount)();
+    const active2 = (0, import_sidekick_shared31.readActiveClaudeAccount)();
     if (jsonOutput) {
       process.stdout.write(JSON.stringify({ action: "added", provider: "claude-code", email: active2?.email, label: opts.label }) + "\n");
     } else {
@@ -81452,14 +81610,14 @@ function claudeAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.remove) {
-    const accounts2 = (0, import_sidekick_shared30.listAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listAccounts)();
     const target = findClaudeAccount(opts.remove, accounts2);
     if (!target) {
       process.stderr.write(source_default.red(`Account "${opts.remove}" not found.`) + "\n");
       process.exit(1);
       return;
     }
-    const result = (0, import_sidekick_shared30.removeAccount)(target.uuid);
+    const result = (0, import_sidekick_shared31.removeAccount)(target.uuid);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to remove account.") + "\n");
       process.exit(1);
@@ -81473,14 +81631,14 @@ function claudeAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.switchTo) {
-    const accounts2 = (0, import_sidekick_shared30.listAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listAccounts)();
     const target = findClaudeAccount(opts.switchTo, accounts2);
     if (!target) {
       process.stderr.write(source_default.red(`Account "${opts.switchTo}" not found.`) + "\n");
       process.exit(1);
       return;
     }
-    const result = (0, import_sidekick_shared30.switchToAccount)(target.uuid);
+    const result = (0, import_sidekick_shared31.switchToAccount)(target.uuid);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to switch.") + "\n");
       process.exit(1);
@@ -81494,17 +81652,17 @@ function claudeAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.switch) {
-    const accounts2 = (0, import_sidekick_shared30.listAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listAccounts)();
     if (accounts2.length < 2) {
       process.stderr.write(source_default.yellow("Need at least 2 saved accounts to switch.") + "\n");
       process.exit(1);
       return;
     }
-    const active2 = (0, import_sidekick_shared30.getActiveAccount)();
+    const active2 = (0, import_sidekick_shared31.getActiveAccount)();
     const currentIdx = active2 ? accounts2.findIndex((a) => a.uuid === active2.uuid) : -1;
     const nextIdx = (currentIdx + 1) % accounts2.length;
     const target = accounts2[nextIdx];
-    const result = (0, import_sidekick_shared30.switchToAccount)(target.uuid);
+    const result = (0, import_sidekick_shared31.switchToAccount)(target.uuid);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to switch.") + "\n");
       process.exit(1);
@@ -81517,9 +81675,9 @@ function claudeAccountAction(opts, jsonOutput) {
     }
     return;
   }
-  const accounts = (0, import_sidekick_shared30.listAccounts)();
+  const accounts = (0, import_sidekick_shared31.listAccounts)();
   if (accounts.length === 0) {
-    const current = (0, import_sidekick_shared30.readActiveClaudeAccount)();
+    const current = (0, import_sidekick_shared31.readActiveClaudeAccount)();
     if (jsonOutput) {
       process.stdout.write(JSON.stringify({ provider: "claude-code", accounts: [], current: current ?? null }) + "\n");
     } else if (current) {
@@ -81531,14 +81689,14 @@ function claudeAccountAction(opts, jsonOutput) {
     return;
   }
   if (jsonOutput) {
-    const active2 = (0, import_sidekick_shared30.getActiveAccount)();
+    const active2 = (0, import_sidekick_shared31.getActiveAccount)();
     process.stdout.write(JSON.stringify({
       provider: "claude-code",
       accounts: accounts.map((a) => ({ ...a, active: a.uuid === active2?.uuid }))
     }, null, 2) + "\n");
     return;
   }
-  const active = (0, import_sidekick_shared30.getActiveAccount)();
+  const active = (0, import_sidekick_shared31.getActiveAccount)();
   process.stdout.write(source_default.bold("Claude Accounts\n"));
   process.stdout.write(source_default.dim("\u2500".repeat(50) + "\n"));
   for (const account of accounts) {
@@ -81585,7 +81743,7 @@ function codexAccountAction(opts, jsonOutput) {
       process.exit(1);
       return;
     }
-    const prepared = (0, import_sidekick_shared30.prepareCodexAccount)(opts.label);
+    const prepared = (0, import_sidekick_shared31.prepareCodexAccount)(opts.label);
     if (!prepared.success) {
       process.stderr.write(source_default.red(prepared.error ?? "Failed to prepare Codex account.") + "\n");
       process.exit(1);
@@ -81603,14 +81761,14 @@ function codexAccountAction(opts, jsonOutput) {
         process.exit(1);
         return;
       }
-      const finalized = (0, import_sidekick_shared30.finalizeCodexAccount)(prepared.profileId);
+      const finalized = (0, import_sidekick_shared31.finalizeCodexAccount)(prepared.profileId);
       if (!finalized.success) {
         process.stderr.write(source_default.red(finalized.error ?? "Failed to finalize Codex account.") + "\n");
         process.exit(1);
         return;
       }
     }
-    const active2 = (0, import_sidekick_shared30.getActiveCodexAccount)();
+    const active2 = (0, import_sidekick_shared31.getActiveCodexAccount)();
     if (jsonOutput) {
       process.stdout.write(JSON.stringify({
         action: "added",
@@ -81626,14 +81784,14 @@ function codexAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.remove) {
-    const accounts2 = (0, import_sidekick_shared30.listCodexAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listCodexAccounts)();
     const target = findCodexAccount(opts.remove, accounts2);
     if (!target) {
       process.stderr.write(source_default.red(`Codex account "${opts.remove}" not found.`) + "\n");
       process.exit(1);
       return;
     }
-    const result = (0, import_sidekick_shared30.removeCodexAccount)(target.id);
+    const result = (0, import_sidekick_shared31.removeCodexAccount)(target.id);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to remove Codex account.") + "\n");
       process.exit(1);
@@ -81647,14 +81805,14 @@ function codexAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.switchTo) {
-    const accounts2 = (0, import_sidekick_shared30.listCodexAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listCodexAccounts)();
     const target = findCodexAccount(opts.switchTo, accounts2);
     if (!target) {
       process.stderr.write(source_default.red(`Codex account "${opts.switchTo}" not found.`) + "\n");
       process.exit(1);
       return;
     }
-    const result = (0, import_sidekick_shared30.switchToCodexAccount)(target.id);
+    const result = (0, import_sidekick_shared31.switchToCodexAccount)(target.id);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to switch Codex account.") + "\n");
       process.exit(1);
@@ -81668,17 +81826,17 @@ function codexAccountAction(opts, jsonOutput) {
     return;
   }
   if (opts.switch) {
-    const accounts2 = (0, import_sidekick_shared30.listCodexAccounts)();
+    const accounts2 = (0, import_sidekick_shared31.listCodexAccounts)();
     if (accounts2.length < 2) {
       process.stderr.write(source_default.yellow("Need at least 2 saved Codex accounts to switch.") + "\n");
       process.exit(1);
       return;
     }
-    const active2 = (0, import_sidekick_shared30.getActiveCodexAccount)();
+    const active2 = (0, import_sidekick_shared31.getActiveCodexAccount)();
     const currentIdx = active2 ? accounts2.findIndex((account) => account.id === active2.id) : -1;
     const nextIdx = (currentIdx + 1) % accounts2.length;
     const target = accounts2[nextIdx];
-    const result = (0, import_sidekick_shared30.switchToCodexAccount)(target.id);
+    const result = (0, import_sidekick_shared31.switchToCodexAccount)(target.id);
     if (!result.success) {
       process.stderr.write(source_default.red(result.error ?? "Failed to switch Codex account.") + "\n");
       process.exit(1);
@@ -81691,7 +81849,7 @@ function codexAccountAction(opts, jsonOutput) {
     }
     return;
   }
-  const accounts = (0, import_sidekick_shared30.listCodexAccounts)();
+  const accounts = (0, import_sidekick_shared31.listCodexAccounts)();
   if (accounts.length === 0) {
     if (jsonOutput) {
       process.stdout.write(JSON.stringify({ provider: "codex", accounts: [], current: null }) + "\n");
@@ -81701,7 +81859,7 @@ function codexAccountAction(opts, jsonOutput) {
     return;
   }
   if (jsonOutput) {
-    const active2 = (0, import_sidekick_shared30.getActiveCodexAccount)();
+    const active2 = (0, import_sidekick_shared31.getActiveCodexAccount)();
     process.stdout.write(JSON.stringify({
       provider: "codex",
       accounts: accounts.map((account) => ({
@@ -81711,7 +81869,7 @@ function codexAccountAction(opts, jsonOutput) {
     }, null, 2) + "\n");
     return;
   }
-  const active = (0, import_sidekick_shared30.getActiveCodexAccount)();
+  const active = (0, import_sidekick_shared31.getActiveCodexAccount)();
   process.stdout.write(source_default.bold("Codex Accounts\n"));
   process.stdout.write(source_default.dim("\u2500".repeat(50) + "\n"));
   for (const account of accounts) {
@@ -81722,12 +81880,12 @@ function codexAccountAction(opts, jsonOutput) {
 `);
   }
 }
-var import_sidekick_shared30;
+var import_sidekick_shared31;
 var init_account = __esm({
   "src/commands/account.ts"() {
     "use strict";
     init_source();
-    import_sidekick_shared30 = __toESM(require_dist(), 1);
+    import_sidekick_shared31 = __toESM(require_dist(), 1);
     init_cli();
   }
 });
@@ -81742,12 +81900,12 @@ async function handoffAction(_opts, cmd) {
   const workspacePath = globalOpts.project || process.cwd();
   const jsonOutput = !!globalOpts.json;
   try {
-    const rawSlug = (0, import_sidekick_shared31.getProjectSlugRaw)(workspacePath);
-    const resolvedSlug = (0, import_sidekick_shared31.getProjectSlug)(workspacePath);
+    const rawSlug = (0, import_sidekick_shared32.getProjectSlugRaw)(workspacePath);
+    const resolvedSlug = (0, import_sidekick_shared32.getProjectSlug)(workspacePath);
     const slugs = rawSlug !== resolvedSlug ? [rawSlug, resolvedSlug] : [rawSlug];
     let content = null;
     for (const slug of slugs) {
-      content = await (0, import_sidekick_shared31.readLatestHandoff)(slug);
+      content = await (0, import_sidekick_shared32.readLatestHandoff)(slug);
       if (content) break;
     }
     if (!content) {
@@ -81772,12 +81930,12 @@ async function handoffAction(_opts, cmd) {
     process.exit(1);
   }
 }
-var import_sidekick_shared31;
+var import_sidekick_shared32;
 var init_handoff = __esm({
   "src/commands/handoff.ts"() {
     "use strict";
     init_source();
-    import_sidekick_shared31 = __toESM(require_dist(), 1);
+    import_sidekick_shared32 = __toESM(require_dist(), 1);
   }
 });
 
@@ -81791,35 +81949,35 @@ function resolveProviderId(opts, defaultProvider = "auto") {
   if (defaultProvider !== "auto") {
     return defaultProvider;
   }
-  return (0, import_sidekick_shared32.detectProvider)();
+  return (0, import_sidekick_shared33.detectProvider)();
 }
 function resolveProvider(opts) {
   const id = resolveProviderId(opts);
   switch (id) {
     case "opencode":
-      return new import_sidekick_shared33.OpenCodeProvider();
+      return new import_sidekick_shared34.OpenCodeProvider();
     case "codex":
-      return new import_sidekick_shared33.CodexProvider();
+      return new import_sidekick_shared34.CodexProvider();
     case "claude-code":
     default:
-      return new import_sidekick_shared33.ClaudeCodeProvider();
+      return new import_sidekick_shared34.ClaudeCodeProvider();
   }
 }
-var import_sidekick_shared32, import_node, import_sidekick_shared33, defaultAccountsReady, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, quotaCmd, statusCmd, accountCmd, handoffCmd;
+var import_sidekick_shared33, import_node, import_sidekick_shared34, defaultAccountsReady, program2, dashCmd, dumpCmd, ctxCmd, reportCmd, searchCmd, tasksCmd, decisionsCmd, notesCmd, statsCmd, quotaCmd, statusCmd, peakCmd, accountCmd, handoffCmd;
 var init_cli = __esm({
   "src/cli.ts"() {
     init_esm();
-    import_sidekick_shared32 = __toESM(require_dist(), 1);
-    import_node = __toESM(require_node(), 1);
     import_sidekick_shared33 = __toESM(require_dist(), 1);
+    import_node = __toESM(require_node(), 1);
+    import_sidekick_shared34 = __toESM(require_dist(), 1);
     (0, import_node.hydratePricingCatalog)({
       cacheDir: path7.join(os5.homedir(), ".config", "sidekick")
     }).catch(() => {
     });
-    defaultAccountsReady = (0, import_sidekick_shared32.ensureDefaultAccounts)().catch(() => {
+    defaultAccountsReady = (0, import_sidekick_shared33.ensureDefaultAccounts)().catch(() => {
     });
     program2 = new Command();
-    program2.name("sidekick").description("Query Sidekick project intelligence from the command line").version("0.17.5").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.17.6").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;
     });
@@ -81879,6 +82037,11 @@ var init_cli = __esm({
       return statusAction2(_opts, cmd);
     });
     program2.addCommand(statusCmd);
+    peakCmd = new Command("peak").description("Show whether Claude is currently in peak hours (faster session-limit drain)").action(async (_opts, cmd) => {
+      const { peakAction: peakAction2 } = await Promise.resolve().then(() => (init_peak(), peak_exports));
+      return peakAction2(_opts, cmd);
+    });
+    program2.addCommand(peakCmd);
     accountCmd = new Command("account").description("Manage saved accounts (list, add, switch, remove)").option("--provider <id>", "Provider: claude-code, codex, auto (default: claude-code)").option("--add", "Save the currently signed-in account").option("--label <name>", "Label for the account (required for Codex, optional for Claude)").option("--switch", "Switch to the next saved account").option("--switch-to <identifier>", "Switch to a specific account by email, label, or id").option("--remove <identifier>", "Remove a saved account by email, label, or id").action(async (_opts, cmd) => {
       const { accountAction: accountAction2 } = await Promise.resolve().then(() => (init_account(), account_exports));
       return accountAction2(_opts, cmd);

package/package.json

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