Release Notes

What's New in SessionWatcher 6.3.18

• No more repeated usage alerts. Once a provider went above 70%, the usage notification could fire again on every refresh. You now get a single alert per level (70%, 90%), and it won't repeat until your usage actually resets.

What's New in SessionWatcher 6.3.17

• Menu bar icons. Show each provider as its brand icon instead of letters (Settings, General).
• Reset countdown when maxed. When a provider's 5-hour limit is full, the menu bar shows the time until it resets.
• Reset alerts. Get notified when a maxed-out provider resets and is usable again (Settings, Notifications).
• Popover switcher. Choose labels or icons for the provider tabs at the top of the popover.
• Help & Feedback. Report a bug, request a feature, or leave a review from the About tab.
• Theme fix. The Settings window now follows Light, Dark, and System.
• Refined dark-mode settings icons and a clearer menu bar style preview.

What's New in SessionWatcher 6.3.16

• Redesigned Settings. A cleaner native settings window with a new sidebar and an Order & Visibility pane for arranging your providers.
• Liquid-glass design. The popover and the floating window now use a translucent glass background.
• Second Claude accounts no longer get stuck on "Rate limited." They now refresh their own login automatically.
• Polish and stability improvements.

What's New in SessionWatcher 6.3.15

• Full Dashboard widget - a new desktop widget (Large & Extra Large) showing your complete Claude usage at a glance: 5-hour session, weekly limits, usage-rate trend, daily history, and token/cost breakdown.
• Floating usage window - pop your usage into an always-on-top window beside your work; one click to pin/unpin, and it follows you across Spaces.

What's New in SessionWatcher 6.3.14

• The free trial now unlocks the full Pro experience - every tool plus all Pro features.
• Plan and pricing refinements.

What's New in SessionWatcher 6.3.13

• OpenCode - a brand-new supported provider. Track tokens, cost, and OpenCode Go limits locally, with no API key. Pro.
• Desktop widgets - a brand-new feature. Put your usage on your desktop with the Tool Focus and Pace Sparkline widgets. Pro.
• Fixes a repeated macOS permission prompt and improves multi-account Claude loading.

OpenCode and desktop widgets are exclusive to SessionWatcher Pro.

What's New in SessionWatcher 6.3.11

• Fixes subscription Claude rate-limit loop. Secondary accounts no longer get stuck in “Rate limited. Will retry in a moment…” for hours: the OAuth usage endpoint now backs off properly on 429 (30s → 60s → 120s → 240s) instead of refreshing the throttle window every 2 minutes.
• Cuts idle power use from Claude Token Usage. The recursive scan of ~/.claude/projects drops from every 60s to every 5 minutes when Claude has been idle for 10 minutes; active sessions still poll at 60s.
• Brings back the “Monochrome menu bar” setting for multi-monitor readability, without the idle-CPU regression that pulled it from 6.3.09.
• Brings back Weekly Sonnet / Claude Design cards at 0% when those Settings toggles are on.
• Fixes a Sparkle relaunch race where the helper could reopen the old build before the installer finished swapping the bundle, forcing some users to update twice.

What's New in SessionWatcher 6.3.10

• Fixes high idle CPU and power usage. Removes a menu bar appearance observer that could trigger continuous AppKit/SwiftUI status-item redraws on current macOS.
• Keeps menu bar rendering lightweight by avoiding provider detection probes during paint and caching parsed Claude reset timestamps.

What's New in SessionWatcher 6.3.07

• Multi-account Claude is back - safely. 6.3.07 re-introduces the macOS Keychain reader for secondary Claude accounts that originally shipped in 6.3.05, with the three bugs that caused that release's CPU/battery regression fixed: the subprocess work now runs off the main thread, the keychain enumeration is cached for 5 minutes instead of running every refresh, and stderr is properly routed so a chatty security subprocess can no longer deadlock the app.
• If you run a personal Claude account at ~/.claude and a work/team account at ~/.claude-work via a shell alias, SessionWatcher now reads each one's OAuth token independently from the Keychain entry Claude Code 2.x writes, without the CPU cost from the 6.3.05 attempt. Claude Team subscriptions also show their real plan label ("team", "max_20x") instead of the previous hardcoded "pro".
• Validated with a new 5-minute idle CPU/power soak test that's now gating every future release - exactly the kind of check that would have caught the 6.3.05 regression before it shipped.

What's New in SessionWatcher 6.3.06

• Hotfix: fixes high CPU / battery use reported on 6.3.05. The multi-account Claude Keychain reader introduced in 6.3.05 could spawn long-running security subprocesses on the main thread for some setups, pegging CPU and burning battery. This release reverts that change so the app returns to the steady, low-energy behavior of 6.3.04. Multi-account Keychain support will return in a future build with the subprocess properly isolated, results cached, and stderr drained.
• If you didn't see the issue, this update is still safe to install - it's functionally identical to 6.3.04 for everyone else.

What's New in SessionWatcher 6.3.05

• Multi-account Claude finally sees your second account's credentials. If you run a personal Claude account at ~/.claude and a work/team account at ~/.claude-work via a shell alias, SessionWatcher now reads each one independently. The previous build picked up the secondary directory but couldn't find the OAuth token because modern Claude Code 2.x stores tokens in the macOS Keychain (not in .credentials.json) and namespaces the entry per config dir. SessionWatcher now derives the correct namespaced Keychain service name to match what Claude Code writes.
• Claude Team subscriptions show their real plan label. Secondary accounts no longer hardcode "pro" - the badge now reflects whatever subscription type your account actually has (Team, Max_20x, etc.), and gracefully handles the case where Anthropic writes a null subscription type for Team users.

What's New in SessionWatcher 6.3.04

• macOS Tahoe 26 menu bar readability fix. The new Liquid Glass menu bar adapts to your wallpaper independently of Light/Dark mode, which previously left SessionWatcher's text rendered in black against a dark menu bar. The app now reads the menu bar's actual effective appearance and updates instantly when your wallpaper changes.
• Inactive tools now read as grey 0%. When you haven't used Codex, Gemini, or Antigravity recently, the menu bar pill renders as a grey "0% ▼0%" instead of a misleading "1% ▲1% red" caused by leftover rolling-window data. The popover's 5-Hour Session card mirrors this - grey card, “Resets in: Unknown”, no scary burn-rate ETA.
• Popover and menu bar always agree. Color tinting now flows from a single source of truth, so you'll never see a green dot in the menu bar contradicted by a red triangle in the popover (and vice versa). When everything's safe, both surfaces say so.
• No more notification spam. The 70% / 90% threshold alerts now use hysteresis: once you've been notified at 70%, the alert won't re-fire until usage drops below 65%. Previously, usage hovering around a threshold could re-fire the same notification on every refresh tick.
• Token Usage card handles big numbers. Heavy users with billions of cached tokens or thousands in monthly cost no longer see values truncated mid-number like "24599...." or "$11000....". The formatter now scales to B/T for tokens and k/M for costs.
• Claude usage now reflects the server value exactly. Previously a clamp held Claude's displayed % at its prior peak within a reset window; with sliding-window roll-off this could keep stale highs visible for hours. Claude % now follows what Anthropic's server reports, which means it can decrease within a window when the rolling usage genuinely drops.
• Codex 5h rate chart no longer drifts during inactivity. When Codex is idle, the chart stops recording new data points so the line doesn't slope downward against zero activity.

What's New in SessionWatcher 6.3.03

• New: Antigravity provider. Live quota and activity tracking for Antigravity IDE and the agy CLI. Off by default - flip it on in Settings → Antigravity to start tracking. Included in Bundle and Pro tiers (and the 7-day trial).

Otherwise, this release is identical to 6.3.02.

What's New in SessionWatcher 6.3.02

• Try SessionWatcher free for 7 days. New installs get an instant trial with all Bundle features unlocked, no credit card. Just click Try free for 7 days at first launch and you're in. The popover shows a small Trial · N days left reminder and a clear Buy a license button so you always know where you stand.
• Trial-ended experience that's hard to miss. The moment your trial runs out, the menu bar swaps the live counters for a Trial ended label, the popover flips to the activation screen with a prominent Buy a license CTA, and a centered popup appears with a one-click path to checkout. No surprise data loss, no confusing silence.
• Settings → License now reflects every state cleanly. Free trial shows days remaining and a streamlined key-paste row. After expiry the same row reappears with the buy link alongside, so a returning user with a key in their inbox can activate without navigating anywhere.

Paid Bundle, Solo, and Pro users see no change to their experience.

What's New in SessionWatcher 6.3.01

• Install on another Mac in one click. The License section now has a Download + copy-link split control under your devices list, so you can grab the latest signed DMG for a second Mac without re-doing the purchase flow. Recurring support request - fixed.
• Dedicated Multi-Account section in Settings (Pro). Sits right after the Providers list. Shows every Claude / Codex account SessionWatcher has discovered on this Mac, with a plain-language three-step guide to adding another and a Scan button that re-checks immediately. Previously the feature was only visible once you already had a second account, which was a discoverability dead end.
• One-time popups now stay one-time. Closing the grandfather welcome (or the notification onboarding nudge) via the red traffic-light button now correctly remembers it was shown. A retain-cycle bug made the close-via-X path silently fail to persist the "shown" flag, so the popup would re-fire on every relaunch. Fixed.

What's New in SessionWatcher 6.3.0

Introducing Pro. The biggest SessionWatcher release yet adds a brand-new tier built for people who live in their AI coding tools every day.

• Multi-account tracking for Claude & Codex. Run a work account and a personal account side by side. SessionWatcher auto-discovers every ~/.claude* and ~/.codex* config directory on your Mac and surfaces each as its own pill in the menu bar and card in the popover. No more logout shuffle to check the other account.
• iCloud sync. Set up SessionWatcher once. Your layout, display modes, and per-tool preferences follow you to every Mac signed in to the same iCloud account. Up to 5 Macs per Pro license.
• 90 days of usage history. The daily-usage chart now cycles between 7d, 30d, and 90d so you can see weekly patterns instead of just the past week. Pro feature.
• Smart switch suggestions across tools. The cross-tool BestToolNow recommendation engine that tells you to hop from Claude to Codex before you hit a wall is now a Pro feature, with an optional menu-bar chip showing the suggested tool prefix.
• Sonnet & Claude Design weekly cards. Dedicated weekly utilization cards for Sonnet and Claude Design on Anthropic Max plans, now bundled into Pro.

For everyone:

• Cleaner onboarding for new installs. Reordered the welcome flow so the license step comes earlier (where the intent is), with background activation that auto-advances the moment a valid key is pasted. No more clicking Activate.
• Smarter notification permission flow. Granting permission in System Settings now auto-closes the in-app prompt and opens the popover so you land straight on your usage view.
• iCloud Sync settings redesigned. Cleaner two-toggle layout (Preferences and Usage Data) with a live cloud status indicator.
• Pro features visibly locked rather than hidden. A small lock badge appears next to features you'd unlock on Pro, so you can see at a glance what's there.

Bundle owners who bought before this release will receive lifetime Pro access at no extra cost as a thank-you for being early supporters. The in-app welcome popup will appear automatically when the upgrade is applied to your license.

What's New in SessionWatcher 6.2.15

• Show each provider only where you want it. Each provider's Settings card now has its own on/off switch in the header, independent of the menu-bar eye toggle. Want Claude on the menu bar but Codex, Cursor and Copilot only when you open the popover, with Gemini hidden entirely? You can do that now. Existing users see no change on upgrade - your current visibility settings carry over to both controls.
• Quick "Check for updates" in the popover footer. Hover the version label and it morphs into a Check for updates button. Click checks Sparkle silently; you'll see Checking… then either Up to date ✓ (auto-fades after 3 seconds) or the blue Update available pill if there's a new version waiting (which stays visible until you install).

What's New in SessionWatcher 6.2.14

• Cursor numbers now match the Cursor dashboard. SessionWatcher was recomputing the usage percentage from totalSpend / limit and drifting from what Cursor itself reports - leading to readings like "100%+" while the dashboard showed Auto/Composer 1% and API 61%. We now use Cursor's own totalPercentUsed directly, dropped the artificial 100% clamp so genuine overage reads honestly, added API quota % and Auto quota % as menu-bar display modes (the per-pool meters Cursor emphasizes), and relabeled the popover ("Spent / $70 included", "Auto & Composer", "API") so it reconciles at a glance with the Cursor dashboard.
• "Update available" pill stays visible long enough to be useful. Sparkle's downloaded-update notification could publish and be wiped within the same SwiftUI tick by the immediate silent-install attempt, leaving no UX feedback even when an update was found. The pill now publishes from the download-finished hook, and the first silent-install attempt is deferred 5 minutes so the pill has time to render and you can choose to install manually if you'd rather not wait.

What's New in SessionWatcher 6.2.13

• Claude now shows as Connected even when ~/.claude/ isn't on this Mac. If you'd previously imported your Claude credentials into SessionWatcher and later wiped or relocated Claude Code's folder (e.g. clean Mac, fresh restore, or just removing the CLI), the popover kept fetching usage correctly from Anthropic - but Settings showed Not installed and the menu bar hid the Claude tile. SessionWatcher now treats working stored credentials as a valid detection signal, matching the same check used to fetch your data. Settings card and menu bar slot light up immediately.

What's New in SessionWatcher 6.2.12

• Claude settings always reachable, even before you've run Claude Code on this Mac. The Claude section in Settings → Providers was hidden until ~/.claude/ existed on the local Mac, which left Bundle and Solo buyers without a path to sign in if they'd never used Claude Code here (e.g. after activating on a new Mac). The card now appears for every entitled user, with a clear Not installed badge when Claude Code isn't present yet - clicking through opens the popover's setup view with both Sign in with Claude (browser OAuth) and Import from Claude CLI (Keychain) buttons.

What's New in SessionWatcher 6.2.11

• Token Usage no longer freezes after a few days. Two related fixes to how Claude Code session logs are read. (1) The parser now walks ~/.claude/projects/ recursively, picking up subagent conversations that live under <session>/subagents/. On a typical install that's 87% of all JSONL files - previously invisible to the parser. (2) Re-scan now runs every 60 seconds on a timer, independent of the kernel file watcher, so writes to existing project files are reflected in the Token Usage card within a minute even when the watcher is silent.

What's New in SessionWatcher 6.2.10

• No more "Disconnect + Import from CLI" dance after a Claude session expires. When your Claude refresh token gets rejected (sleep > 24h, account change, Anthropic rotating sessions), SessionWatcher now silently re-imports fresh credentials from Claude Code's Keychain in the background. Reconnects in seconds with zero clicks, even when modern Claude Code keeps its tokens in the Keychain instead of the on-disk credentials file.

What's New in SessionWatcher 6.2.9

• Hotfix for 6.2.8: dedupe the Claude usage fetch on app launch so Sparkle's silent-install path no longer trips an HTTP 429 against Anthropic's Admin API right after auto-update. The stale-data-after-sleep fix from 6.2.8 is preserved - any launch with a cache older than 60 seconds still performs the authoritative fetch.

What's New in SessionWatcher 6.2.8

• Fixed a flicker where Claude and Codex menu-bar percentages could briefly move backward after wake or relaunch when a stale-but-valid reading arrived behind a fresher one. The menu bar now holds the higher value until the window actually resets.
• Claude now performs one authoritative fetch on app launch instead of trusting cached values, so weekly and session numbers cannot stay stale across a sleep or shutdown resume.

What's New in SessionWatcher 6.2.7

• Fixed Codex 5-hour session reset display after a rolling window expires and the next Codex CLI or Desktop session starts.
• SessionWatcher now infers the active Codex 5-hour reset from fresh local Codex activity when OpenAI returns weekly usage but omits the 5-hour reset window.
• Expanded Codex reset parsing for alternate RPC and log payload fields.
• Removed the misleading Resets in: Unavailable 5-hour card when token usage exists but no real or inferable 5-hour window is available.

What's New in SessionWatcher 6.2.6

Bulletproof reconnect. A coordinated overhaul of how SessionWatcher handles expired Claude and Codex sessions. The login screen should now appear only as a true last resort.

• Instant auto-reconnect after /login. SessionWatcher watches ~/.claude/.credentials.json and ~/.codex/auth.json at the kernel level. The moment Claude Code or Codex CLI writes fresh tokens, we re-ingest them in under a second - no clicks, no popovers, your numbers never disappear.
• Graceful expired-session UX. If your refresh token gets rejected, the popover now keeps showing your last-known usage cards with a small amber "session expired" banner instead of replacing everything with a sign-in screen.
• Cooperative token ownership with Claude Code. SessionWatcher now defers to Claude Code's credentials file when its access token is fresher. Eliminates the rotating-refresh-token race that caused most "got disconnected after sleep" reports.
• 5-minute refresh-token grace window. When Anthropic or OpenAI rejects a refresh token because another app rotated it first, SessionWatcher transparently retries with the previous token before giving up.
• Smarter transient classification. Cloudflare hiccups, 5xx errors, HTML error pages, and empty-body failures are now retried silently every 2 minutes instead of logging you out. Only an explicit invalid_grant from the OAuth provider triggers a re-login prompt.

What's New in SessionWatcher 6.2.4

• Fixed a cosmetic bug where the popover's Mac-count display read "X of 1 Mac" for Solo licenses, even though the license actually supports up to 3 Macs. The display now reads the real seat limit from your license rather than a hardcoded per-tier value.

What's New in SessionWatcher 6.2.3

• Hover the "Updated X ago" status line in the popover footer to see the exact clock time of the last successful fetch (e.g. "Last updated at 11:42:07 PM"). The relative timestamp is great for at-a-glance scanning; the tooltip gives you a precise answer when you need it.

What's New in SessionWatcher 6.2.2

• Truly silent auto-updates. Future versions now install themselves seamlessly in the background while you're working - the menu bar icon briefly disappears, and a few seconds later it's back on the new version with zero clicks from you. SessionWatcher waits for a moment when you're not actively using the popover or Settings before restarting, so you'll never lose your place.

What's New in SessionWatcher 6.2.1

• When SessionWatcher is reconnecting to Claude or Codex after a network blip, it now shows the absolute time of the last successful fetch (e.g. "last updated 9:42 PM") instead of an elapsed-minutes count that becomes stale the moment you read it.

What's New in SessionWatcher 6.2.0

• Stays connected through sleep and network blips. A new wake/network coordinator force-refreshes Claude and Codex the moment your Mac wakes up or your Wi-Fi comes back, so the menu bar can't get stuck on stale data overnight.
• Codex no longer freezes on transient failures. Brief 5xx errors, decode glitches, or wake/network races are now retried automatically instead of leaving Codex displaying hours-old numbers.
• Silent self-healing for Claude. If your Claude refresh token gets rejected, SessionWatcher quietly polls Claude Code's credentials file in the background and re-imports the moment fresh tokens appear, with no user action.
• Proactive token refresh. Claude tokens are refreshed before they expire, eliminating the wake-up race that caused yesterday's disconnects.
• Automatic updates from now on. SessionWatcher will silently install future versions in the background. You can turn this off in Settings → Software Update if you prefer manual updates.

What's New in SessionWatcher 6.1.1

• Connection stability: fixed Claude disconnecting after a Mac sleeps overnight or briefly loses network. Transient refresh failures (network blips, server 5xx) are now retried with backoff instead of kicking users to the sign-in screen.
• Only genuine OAuth rejections from Anthropic now trigger the reconnect flow. Everything else stays connected with cached usage visible.

What's New in SessionWatcher 6.1.0

• New first-launch onboarding walks you through notifications, license, and detected tools.
• Notifications fixed - the silent auto-deny that affected many users on 6.0.x is resolved; existing users get a one-time prompt to enable.
• Cursor no longer re-enables itself after every reboot.
• GitHub Copilot keeps its auth across reboots (was prompting for re-login).
• Claude shows a clear Sign-In button when its token refresh fails, instead of a static red error.
• Sign in with ChatGPT now shows a clear error if port 1455 is busy (e.g. Codex CLI is open), instead of a vague "unknown_error".
• Gemini quota stays stable when Google's API misbehaves (was flipping between 0% and 100%).
• Codex Usage Rate chart is clean with no active 5-hour session (was a red/green flat line).
• Copilot rate now visible in the menu bar from day 1 of the cycle, with the correct arrow color at 0% used.
• Global hotkey ⌘⇧U is more reliable (now uses macOS Carbon hotkeys, works across all apps).
• Updated app icon.
• Plus a long list of smaller UX fixes throughout Settings, the popover, and the menu bar.

What's New in SessionWatcher 6.0.3

• Fixed Claude Max plan badges so Max 5x and Max 20x are shown correctly after upgrading from Pro
• Fixed Codex plan badge persistence after relaunch
• Added the SessionWatcher icon next to the menu bar status dot for clearer visibility when disconnected
• Updated the license screen to use the official SessionWatcher icon
• Scoped Best Tool Now to Claude/Codex cap windows and removed misleading web dashboard open buttons

What's New in SessionWatcher 6.0.2

• Use SessionWatcher on up to 3 Macs with one license - install on each Mac and your devices appear in Settings.
• Manage your devices: see all activated Macs, sign out from any of them, free a slot when you switch laptops.
• Email-based license recovery: if you bought before the license-key system, just enter your purchase email and we'll set you up.
• Smaller fixes for the first-launch entitlement flicker after upgrading from v5.

What's New in SessionWatcher 6.0

• Added GitHub Copilot usage monitoring
• Added Cursor usage monitoring
• Added Gemini Code Assist usage monitoring
• Bigger, vertically-centered percentage display in the menu bar
• New 6-license model: 5 individual tool licenses or 1 Bundle that unlocks all five

What's New in SessionWatcher 5.2.4

• Codex usage now works without the Codex CLI installed (browser sign-in is enough)
• Lower battery use: refresh cadence aligned with Claude (90–120s, 60s minimum)
• Graceful handling of OpenAI rate limits (429 with Retry-After)

What's New in SessionWatcher 5.2.3

• Disabled Best Tool Now recommendation card
• Fixed API rate limiting for Claude (2-minute minimum refresh)

What's New in SessionWatcher 5.2.2

• Fixed API rate limiting errors for Claude users by increasing minimum refresh interval to 2 minutes
• Reduced power consumption from frequent API polling

What's New in SessionWatcher 5.2.0

• Cleaner daily usage chart: removed trend line overlay for a simpler view
• Liquid glass UI refinements

What's New in SessionWatcher 5.1.0

• Sign in with your Claude account directly from the app (no Claude Code CLI needed)
• Works with Claude Desktop, Claude Code, and all Claude products
• Fixed "API rate limited" getting permanently stuck for new users
• Added reconnect button in settings
• Improved rate limit recovery

What's New in SessionWatcher 4.5.1

• Fixed auto-update installation on macOS Tahoe (26.x)
• Upgraded Sparkle framework to 2.9.0
• Fixed update detection for users on older versions
• Release notes now shown in update dialog

What's New in SessionWatcher 4.5

• Fixed update system for all users, including those on older versions
• Shows days remaining in weekly limit countdown when more than 24 hours left
• Improved reset time display with absolute times (e.g. "resets at 2:00 PM")
• Redesigned settings with notifications at 50%, 75%, and 90% usage
• Dynamic menu bar dot indicator for at-a-glance usage status
• Better handling of rate limit errors with automatic backoff

What's New in SessionWatcher 4.4

• Shows days remaining in weekly limit countdown when more than 24 hours left

What's New in SessionWatcher 4.2

• Show absolute reset time (e.g. "1h 13m, resets at 2:00 PM")

What's New in SessionWatcher 4.1

• Fixed token expiration handling
• Resolved keychain permission prompts

What's New in SessionWatcher 4.0

• Complete rewrite with OAuth API authentication
• Colored rate limit arrows in the menu bar
• Automatic update checks via Sparkle