v1.3.16

📦 Now on the Windows Package Manager

Claude Code Tray is now installable with a single command:

winget install alegauss.ClaudeCodeTray

This release is about distribution and automation — the app itself is unchanged since v1.3.14 (same tray icon, projection, reset toasts, and 24h usage insights).

Highlights

• winget package — alegauss.ClaudeCodeTray, with English (en-US) and Brazilian Portuguese (pt-BR) manifest locales.
• Automated release pipeline — a GitHub Actions workflow builds the self-contained installer, publishes the GitHub Release, regenerates the winget manifests, and opens the winget-pkgs PR. The manifest's InstallerSha256 is computed from the exact .exe attached here, so it always matches.
• Refreshed website & README — install via winget front and center, with a copy-to-clipboard button on the command.

Install

• winget: winget install alegauss.ClaudeCodeTray
• Direct download: grab ClaudeTray-Setup.exe below (per-user install, no admin). Existing installs self-update automatically.

---

Full Changelog: v1.3.14...v1.3.16

v1.3.14

What's new in v1.3.14

🎚️ Minimum-usage thresholds for reset notifications

Reset pings from a barely-touched window are noise, so you can now set a floor below which they stay quiet:

• Session resets — notify only above 2% by default
• Weekly resets — notify only above 5% by default

Drag the sliders in Settings → Notifications to tune each floor (0–100%). A reset from a window you'd hardly used is skipped instead of buzzing you.

🔔 Dedicated Notifications page

All reset-notification toggles now live on their own Notifications page in Settings, alongside the new threshold sliders — easier to find and tune. Every reset notification is now enabled by default.

🧹 Cleaner tray icon

• Removed the "needs auth" badge — the icon no longer overlays an auth marker.
• Fixed glyph centering so the rendered icon sits true to center.

🛠 Under the hood

• New reusable SettingsRow control gives the Settings window a more consistent, aligned layout.

Full Changelog: v1.3.12...v1.3.14

v1.3.12

What's new in v1.3.12

🎨 Color-coded reset notifications

Each usage-reset notification now has its own color, so you can tell them apart at a glance:

• 🟧 Surprise! — your weekly limit reset earlier than scheduled
• 🟩 New week! — the routine weekly reset
• 🟪 Bonus! — usage was partially credited back mid-week (e.g. 91% → 50%)
• 🟦 Fresh session! — your 5-hour session window reset

Each type can be turned on/off independently in Settings → Notifications.

🐛 Fixes

• The tray icon now shows red at 100% usage instead of green — a flat-usage burn-rate projection was misreading "maxed out" as "on track".
• The update check now tolerates malformed release tags (e.g. v.1.3.8), so a tag typo can no longer silently break auto-update.

v1.3.10

What's new in v1.3.10

🔔 Usage-reset notifications

Claude Code Tray now pops a notification the moment your usage frees up, so you know your quota is back:

• Unexpected reset — your weekly limit reset earlier than its scheduled deadline (a known Claude Code quirk).
• Routine weekly reset — the normal weekly refresh.
• Partial credit — weekly usage dropped mid-week without a full reset (e.g. 91% → 50%).

Each notification is opt-in/out under Settings → Notifications, and every event is also written to reset-events.log for reference.

🛠 Improvements

• Refined the tray tooltip's burn-rate projection handling.

Newer in v1.3.12: a distinct color per notification type and a 5-hour session-reset notification.

Full Changelog: v1.3.8...v1.3.10

v1.3.8

Claude Code Tray v1.3.8

This release focuses on smarter authentication handling — the tray now tells you exactly what to do when it can't read your usage, instead of showing a raw error.

✨ Improvements

• Targeted auth messages. The tray now distinguishes two cases and guides you accordingly:
  • "session expired" — your access token expired but a refresh token is on disk, so no login is needed: just open Claude Code and it refreshes silently.
  • "not signed in" — there's no refresh token (or no credentials file), so a full /login is required.
• Clearer not-signed-in state. A missing or incomplete ~/.claude/.credentials.json now shows a friendly "sign in to Claude Code" prompt instead of a raw file-not-found error.
• Smarter terminal hint. Opening Claude Code for re-auth prints the right next step in the terminal — "refreshing your session…" vs. "type /login…" — depending on which is actually needed.
• More resilient polling. Transient network/API blips (timeouts, 5xx, 429) are ridden out for a poll or two and retried quietly, instead of flipping the icon to a scary error on a single hiccup.

🧹 Maintenance

• Removed winget packaging (manifests + generator script). Releases are distributed via the GitHub Releases installer; the in-app self-update is unchanged.
• Added an authentication & Terms-of-Service advisory to the README, explaining how the tray uses your subscription OAuth credentials and the boundaries of that use.

📦 Install

Download ClaudeTray-Setup.exe below (per-user install, no admin). Existing installs update automatically.

Full Changelog: v1.3.6...v.1.3.8

v1.3.6

Claude Code Tray v1.3.6

Faster recovery when your token expires, more control over how Claude Code launches, and a new About page.

✨ What's new

• Open Claude Code from a double-click. Double-clicking the tray icon now launches Claude Code — the same as the Open Claude Code menu item, without opening the menu first.
• Configurable working directory. Settings → Claude Code lets you choose the directory Claude Code opens in (for the menu item, the double-click, and auto-open). It defaults to your home directory; clear the field to reset.
• Auto-open when signed out. A new option launches Claude Code automatically the moment a poll detects an expired token (HTTP 401), so you can re-authenticate without hunting for the menu. It fires once per signed-out spell, not on every retry.
• Faster retry while signed out. When the token is expired, the tray now re-checks on a tighter cadence (default 10 s) until you sign back in, then returns to your normal refresh interval. The retry interval is configurable in Settings.
• New About page. Settings gained an About section with the app logo, version, a project overview, quick links (repository, releases, issues, star), and a short "Get involved" guide for contributors.

📝 Notes

• Settings is now a two-page window (General / About); the content scrolls so nothing is clipped on smaller windows.

Full Changelog: v1.3.4...v1.3.6

v1.3.4

Claude Code Tray v1.3.4

Smarter usage projection for the weekly window, a clearer tooltip, and your display choice now sticks.

✨ What's new

• Weekly (7d) pace-line projection. The 7-day window now decides danger with a proportional pace line — comparing your usage against the share an even, constant burn would have spent by now (elapsed ÷ 7 days). It's accurate from the very first reading (no warm-up needed) and a short burst over a 7-day window no longer trips a false alarm the way a slope fit could.
• Rule-of-three ETA for the week. The projected time to 100% is derived from your average pace since the window started (elapsed × (100 − used) ÷ used), so the tooltip shows a concrete time instead of a vague warning. The 5h session and Extra windows keep the existing burn-rate (least-squares) projection.
• Projection labelled by window. The tooltip line now names the active metric — e.g. Week 7d projection: 100% in 1d 14h (before reset) — so it's clear whether you're looking at the session or the week.
• Selected window is remembered. Your Show on icon choice (Session 5h / Week 7d / Extra) now persists across restarts instead of resetting to 5h.

📝 Docs

• README and website updated to describe the pace-line vs. burn-rate projection methods.

Full Changelog: v1.3.2...v1.3.4

v1.3.2

Polishes the expired-token experience, makes the polling cost explicit, and tidies up Settings.

✨ New

• "Needs auth" tray icon: on a 401 (expired token) the icon now shows a gray tile with a medium orange play ▶ badge — signalling "re-authenticate to resume" rather than a generic error. It disappears automatically once a poll succeeds again (e.g. after Open Claude Code refreshes the token).
• Live heartbeat cost estimate in Settings: the Refresh section now shows, for the chosen interval, exactly what the polling "heartbeat" consumes — calls/hour, tokens/hour and per day, plus the equivalent pay-as-you-go API cost per month. It recalculates live as you move the slider. Each refresh is one 1-token Haiku call sent with your Claude Code login, so it uses a sliver of your usage, not a separate bill.

🎨 Improvements

• "Start with Windows" moved into Settings: the autostart toggle now lives under a new Startup section in Settings… (it used to be a top-level tray-menu item), keeping all configuration in one place.

🔧 Internal

• Added sitemap.xml, robots.txt, and llms.txt to the site for search-engine and LLM discoverability.

Full Changelog: v1.3.0...v1.3.2

v1.3.0

A big one: a proper Settings window, a clearer authentication flow, and a project website.

✨ New

• Settings window: a native, non-modal Windows 11 (Fluent) dialog — right-click → Settings…. Adjust the refresh interval (how often your usage is polled) with a slider, and your choices follow the Windows light/dark theme and accent color.
• Show usage % on the icon: a new toggle to draw the percentage number on the tray icon, or keep just the fill bar.
• Clearer authentication state: when the OAuth token expires, the tooltip now reads not authenticated (HTTP 401) instead of a generic error — and a new Open Claude Code menu item launches the Claude Code CLI so it can refresh the token. This is the common case on the first poll after a reboot.
• Project website: a landing page at https://alegauss.github.io/claude-tray/.

🎨 Improvements

• Usage bar color: the bar now warms from orange toward red as usage approaches the limit when the projection says you'll run out before the window resets (it was a flat red before).
• Digit rendering: better scaling and centering so single-digit numbers stay sharp and don't touch the icon edges.

🔧 Internal

• Hardened error handling and token handling in the API client.
• New dev tooling: a UI-preview skill and a window-capture script to visually verify the Settings window, plus an AGENTS.md.

Full Changelog: v1.2.2...v1.3.0

v1.2.2

A maintenance-friendly release: update the app directly from within it, a refreshed icon look, and more info in the tooltip.

✨ New

• In-app updates (auto-update): the app checks GitHub Releases on launch and every 6 hours. When a newer version is available, it shows a notification and an "Update to vX.Y.Z" menu item — clicking it downloads and installs the update automatically (per-user install, no admin) and relaunches on the new version.
• Last refresh time in the tooltip: the Status line now shows the time of the last API read (HH:mm:ss).

🎨 Improvements

• Refreshed icon look: a calm slate blue-gray background instead of the orange (which always read like a warning), with a neon-green usage bar. Red is still used when the projection indicates you'll hit the limit before the window resets.
• Digit centering: single-digit numbers no longer touch the edges of the icon.

🔧 Internal

• Streamlined release process: the version now has a single source of truth in ClaudeTray.csproj — the installer reads it from the published .exe, and the winget manifests are regenerated by a script.

Full Changelog: v1.2.0...v1.2.2