Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/animation.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed .github/screenshot.png
Binary file not shown.
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions Cargo.toml
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
25 changes: 21 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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:
Expand Down
1 change: 1 addition & 0 deletions src/main.rs
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ mod models;
mod native_interop;
mod poller;
mod theme;
mod tray_icon;
mod updater;
mod window;

Expand Down
1 change: 1 addition & 0 deletions src/native_interop.rs
Original file line number Diff line number Diff line change
Expand Up @@ -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> {
Expand Down
Loading