Merge pull request #6 from usamaiqb/feature/tray-icon

- Added a native system tray icon with a live usage badge for the current 5-hour window.
- Left-clicking the tray icon now toggles the taskbar widget on and off.
- Right-click tray menu support now mirrors the widget menu, including refresh, startup, position reset, language, updates, and exit.
- The app now remembers whether the taskbar widget was hidden or visible between launches.
- Improved Windows app identity by using the proper app name and embedded icon metadata in shell surfaces.
- Refined tray icon styling and usage-state colouring for clearer at-a-glance monitoring.

Author: CodeZeno

.github/animation.gif

@@ -1,16 +1,16 @@
 [package]
 name = "claude-code-usage-monitor"
-version = "1.2.10"
+version = "1.2.11"
 edition = "2021"
 license = "MIT"
-description = "Windows taskbar widget for monitoring Claude Code usage and rate limits"
+description = "Claude Code Usage Monitor"
 homepage = "https://codezeno.com.au"
 repository = "https://github.com/CodeZeno/Claude-Code-Usage-Monitor"
 
 [package.metadata.winres]
 CompanyName = "Code Zeno Pty Ltd"
 ProductName = "Claude Code Usage Monitor"
-FileDescription = "Windows taskbar widget for monitoring Claude Code usage and rate limits"
+FileDescription = "Claude Code Usage Monitor"
 OriginalFilename = "claude-code-usage-monitor.exe"
 InternalName = "ClaudeCodeUsageMonitor"
 Comments = "https://codezeno.com.au"

.github/screenshot.png

@@ -7,14 +7,16 @@ It sits in your taskbar and shows how much of your Claude Code usage window you
 ![Windows](https://img.shields.io/badge/platform-Windows-blue)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-![Screenshot](.github/screenshot.png)
+![Screenshot](.github/animation.gif)
 
 ## What You Get
 
 - A **5h** bar for your current 5-hour Claude usage window
 - A **7d** bar for your current 7-day window
 - A live countdown until each limit resets
 - A small native widget that lives directly in the Windows taskbar
+- A **system tray icon** showing your usage percentage as a color-coded badge
+- Left-click the tray icon to toggle the taskbar widget on or off
 - Right-click options for refresh, update frequency, language, startup, and updates
 
 ## Who This Is For
@@ -48,12 +50,27 @@ After installing with WinGet, run:
 claude-code-usage-monitor
 ```
 
-Once running, it will appear in your taskbar.
+Once running, it will appear in your taskbar and as a tray icon in the notification area.
 
-- Drag the left divider to move it
-- Right-click for refresh, update frequency, Start with Windows, reset position, language, updates, and exit
+- Drag the left divider to move the taskbar widget
+- Right-click the taskbar widget or tray icon for refresh, update frequency, Start with Windows, reset position, language, updates, and exit
+- Left-click the tray icon to toggle the taskbar widget on or off
 - Enable `Start with Windows` from the right-click menu if you want it to launch automatically when you sign in
 
+### System Tray Icon
+
+The tray icon shows your current 5-hour usage as a color-coded percentage badge:
+
+| Color  | Meaning           |
+|--------|-------------------|
+| Green  | Under 50% used    |
+| Yellow | 50–75% used       |
+| Orange | 75–90% used       |
+| Red    | 90% or more used  |
+| Gray   | No data available |
+
+Hovering over the tray icon shows a tooltip with both your 5h and 7d usage.
+
 ## Diagnostics
 
 If you need to troubleshoot startup or visibility issues, run:

Cargo.lock

@@ -6,6 +6,7 @@ mod models;
 mod native_interop;
 mod poller;
 mod theme;
+mod tray_icon;
 mod updater;
 mod window;
 

Cargo.toml

@@ -22,6 +22,7 @@ pub const TIMER_UPDATE_CHECK: usize = 4;
 // Custom messages
 pub const WM_APP: u32 = 0x8000;
 pub const WM_APP_USAGE_UPDATED: u32 = WM_APP + 1;
+pub const WM_APP_TRAY: u32 = WM_APP + 3;
 
 /// Get the taskbar window handle
 pub fn find_taskbar() -> Option<HWND> {