You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+33-11Lines changed: 33 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,30 +5,34 @@
5
5
6
6

7
7
8
-
A lightweight Windows taskbar widget for people already using Claude Code.
8
+
A lightweight Windows taskbar widget for people already using Claude Code, with optional Codex usage display.
9
9
10
-
It sits in your taskbar and shows how much of your Claude Code usage window you have left, without needing to open the terminal or the Claude site.
10
+
It sits in your taskbar and shows how much of your Claude Code and/or Codex usage window you have left, without needing to open the terminal or the provider site.
11
11
12
12
## What You Get
13
13
14
14
- A **5h** bar for your current 5-hour Claude usage window
15
15
- A **7d** bar for your current 7-day window
16
+
- Optional Codex usage bars alongside Claude Code
16
17
- A live countdown until each limit resets
17
18
- A small native widget that lives directly in the Windows taskbar
18
-
-A **system tray icon**showing your usage percentage as a color-coded badge
19
+
-System tray icon badges showing your enabled model usage percentage
19
20
- Left-click the tray icon to toggle the taskbar widget on or off
20
-
- Right-click options for refresh, update frequency, language, startup, and updates
21
+
- Right-click options for refresh, displayed models, update frequency, language, startup, and updates
21
22
22
23
## Who This Is For
23
24
24
25
This app is for Windows users who already have **Claude Code (CLI or App) installed and signed in**.
25
26
27
+
Codex support is optional. To show Codex usage, install and sign in to the Codex CLI, then enable Codex from the right-click **Models** menu.
28
+
26
29
It works best if you want a simple "how close am I to the limit?" display that is always visible.
27
30
28
31
## Requirements
29
32
30
33
- Windows 10 or Windows 11
31
34
- Claude Code (CLI or App) installed and authenticated
35
+
- Optional: Codex CLI installed and authenticated, if you want Codex usage
32
36
33
37
If you use Claude Code through WSL, that is supported too. The monitor can read your Claude Code credentials from Windows or from your WSL environment.
34
38
@@ -50,18 +54,31 @@ After installing with WinGet, run:
50
54
claude-code-usage-monitor
51
55
```
52
56
53
-
Once running, it will appear in your taskbar and as a tray icon in the notification area.
57
+
Once running, it will appear in your taskbar and as one or more tray icons in the notification area.
54
58
55
59
- Drag the left divider to move the taskbar widget
56
-
- Right-click the taskbar widget or tray icon for refresh, update frequency, Start with Windows, reset position, language, updates, and exit
60
+
- Right-click the taskbar widget or tray icon for refresh, displayed models, update frequency, Start with Windows, reset position, language, updates, and exit
57
61
- Left-click the tray icon to toggle the taskbar widget on or off
58
62
- Enable `Start with Windows` from the right-click menu if you want it to launch automatically when you sign in
59
63
64
+
### Models
65
+
66
+
Use the right-click **Models** menu to choose what the widget displays:
67
+
68
+
-**Claude Code** is enabled by default
69
+
-**Codex** can be enabled alongside Claude Code or shown by itself
70
+
71
+
When both models are shown, each model has its own usage bar and matching usage text color.
72
+
60
73
### System Tray Icon
61
74
62
-
The tray icon shows your current 5-hour usage as a color-coded percentage badge.
75
+
The tray icon shows your current 5-hour usage as a percentage badge.
76
+
77
+
If both Claude Code and Codex are enabled, the app shows two tray icons: one for Claude Code and one for Codex. If only one model is enabled, it shows one tray icon.
78
+
79
+
The Claude Code tray icon uses the same warm usage colors as the Claude bar. The Codex tray icon uses a black and white badge style.
63
80
64
-
Hovering over the tray icon shows a tooltip with both your 5h and 7d usage.
81
+
Hovering over a tray icon shows the usage values for that model.
65
82
66
83
## Diagnostics
67
84
@@ -102,10 +119,12 @@ What the app reads:
102
119
103
120
- Your local Claude Code OAuth credentials from `~/.claude/.credentials.json`
104
121
- If needed, the same credentials file inside an installed WSL distro
122
+
- If Codex is enabled, your local Codex credentials from `$CODEX_HOME/auth.json` or `~/.codex/auth.json`
105
123
106
124
What the app sends over the network:
107
125
108
126
- Requests to Anthropic's Claude endpoints to read your usage and rate-limit information
127
+
- Requests to ChatGPT's Codex usage endpoint to read your Codex usage and rate-limit information, if Codex is enabled
109
128
- Requests to GitHub only if you use the app's update check / self-update feature
110
129
- If proxy environment variables such as `HTTPS_PROXY`, `HTTP_PROXY`, or `ALL_PROXY` are set, those outbound requests may use that proxy
111
130
@@ -115,26 +134,29 @@ What the app stores locally:
115
134
- Polling frequency
116
135
- Language preference
117
136
- Last update check time
137
+
- Displayed model preferences
118
138
119
139
What it does **not** do:
120
140
121
141
- It does not send your credentials to any other server
122
142
- It does not use a separate backend service
123
143
- It does not collect analytics or telemetry
124
144
- It does not upload your project files
145
+
- It does not directly edit your Codex credentials file
125
146
126
147
Notes:
127
148
128
149
- If your Claude Code token is expired, the app may ask the local Claude CLI to refresh it in the background
150
+
- If your Codex token is expired, the app may ask the local Codex CLI to refresh it in the background. The monitor does not write `auth.json` itself; any credential update is handled by the Codex CLI.
129
151
- Portable installs can update themselves by downloading the latest release from this repository
130
-
- Proxies should be trusted because proxied Claude requests include your OAuth bearer token inside the TLS connection
152
+
- Proxies should be trusted because proxied usage requests include your OAuth bearer token inside the TLS connection
131
153
132
154
## How It Works
133
155
134
156
The monitor:
135
157
136
-
1. Finds your Claude Code login credentials
137
-
2. Reads your current usage from Anthropic
158
+
1. Finds your enabled model login credentials
159
+
2. Reads your current usage from Anthropic and/or ChatGPT
138
160
3. Shows the result directly in the Windows taskbar
token_expired_body:"Exécutez 'claude' dans un terminal, puis utilisez '/login' et suivez les instructions. Ensuite, actualisez ou redémarrez cette application.",
codex_token_expired_body:"Executez 'codex' dans un terminal et suivez les instructions de connexion. Ensuite, actualisez ou redemarrez cette application.",
token_expired_body:"Führen Sie 'claude' in einem Terminal aus, verwenden Sie dann '/login' und folgen Sie den Anweisungen. Aktualisieren oder starten Sie diese App anschließend neu.",
codex_token_expired_body:"Fuhren Sie 'codex' in einem Terminal aus und folgen Sie den Anmeldeanweisungen. Aktualisieren oder starten Sie diese App anschliessend neu.",
0 commit comments