Skip to content
Open
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
20 changes: 14 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,16 @@

![Screenshot](.github/animation.gif)

A lightweight Windows taskbar widget for people already using Claude Code, with optional Codex usage display.
A lightweight Windows taskbar widget for people already using Claude Code, with optional Codex and Google Antigravity usage display.

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.
It sits in your taskbar and shows how much of your Claude Code, Codex, and/or Antigravity usage window you have left, without needing to open the terminal or the provider site.

## What You Get

- A **5h** bar for your current 5-hour Claude usage window
- A **7d** bar for your current 7-day window
- Optional Codex usage bars alongside Claude Code
- Optional Antigravity usage bars for Google's 5-hour and broader user quota windows
- A live countdown until each limit resets
- A small native widget that lives directly in the Windows taskbar
- System tray icon badges showing your enabled model usage percentage
Expand All @@ -26,13 +27,16 @@ This app is for Windows users who already have **Claude Code (CLI or App) instal

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.

Antigravity support is optional too. To show Antigravity usage, install and sign in to Google Antigravity, then enable Antigravity from the right-click **Models** menu.

It works best if you want a simple "how close am I to the limit?" display that is always visible.

## Requirements

- Windows 10 or Windows 11
- Claude Code (CLI or App) installed and authenticated
- Optional: Codex CLI installed and authenticated, if you want Codex usage
- Optional: Google Antigravity installed and authenticated, if you want Antigravity usage

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.

Expand Down Expand Up @@ -67,16 +71,17 @@ Use the right-click **Models** menu to choose what the widget displays:

- **Claude Code** is enabled by default
- **Codex** can be enabled alongside Claude Code or shown by itself
- **Antigravity** can be enabled alongside the other providers or shown by itself

When both models are shown, each model has its own usage bar and matching usage text color.
When multiple models are shown, each model has its own usage bar and matching usage text color.

### System Tray Icon

The tray icon shows your current 5-hour usage as a percentage badge.

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.
If multiple providers are enabled, the app shows one tray icon per provider. If only one model is enabled, it shows one tray icon.

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.
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. The Antigravity tray icon uses a green badge style.

Hovering over a tray icon shows the usage values for that model.

Expand Down Expand Up @@ -120,11 +125,13 @@ What the app reads:
- Your local Claude Code OAuth credentials from `~/.claude/.credentials.json`
- If needed, the same credentials file inside an installed WSL distro
- If Codex is enabled, your local Codex credentials from `$CODEX_HOME/auth.json` or `~/.codex/auth.json`
- If Antigravity is enabled, your local Antigravity OAuth token from Windows Credential Manager target `gemini:antigravity`

What the app sends over the network:

- Requests to Anthropic's Claude endpoints to read your usage and rate-limit information
- Requests to ChatGPT's Codex usage endpoint to read your Codex usage and rate-limit information, if Codex is enabled
- Requests to Google's Cloud Code / Antigravity endpoints to read your Antigravity quota information, if Antigravity is enabled
- Requests to GitHub only if you use the app's update check / self-update feature
- If proxy environment variables such as `HTTPS_PROXY`, `HTTP_PROXY`, or `ALL_PROXY` are set, those outbound requests may use that proxy

Expand All @@ -148,6 +155,7 @@ Notes:

- If your Claude Code token is expired, the app may ask the local Claude CLI to refresh it in the background
- 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.
- If your Antigravity token is expired, open Antigravity and sign in again. The monitor does not write Windows Credential Manager entries itself.
- Portable installs can update themselves by downloading the latest release from this repository
- Proxies should be trusted because proxied usage requests include your OAuth bearer token inside the TLS connection

Expand All @@ -156,7 +164,7 @@ Notes:
The monitor:

1. Finds your enabled model login credentials
2. Reads your current usage from Anthropic and/or ChatGPT
2. Reads your current usage from Anthropic, ChatGPT, and/or Google's Antigravity endpoints
3. Shows the result directly in the Windows taskbar
4. Refreshes periodically in the background

Expand Down
4 changes: 4 additions & 0 deletions src/localization/dutch.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Modellen",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Instellingen",
start_with_windows: "Opstarten met Windows",
reset_position: "Positie herstellen",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "Voer 'claude' uit in een terminal, gebruik daarna '/login' en volg de stappen. Ververs of herstart de app daarna.",
codex_token_expired_title: "Codex-authenticatiefout",
codex_token_expired_body: "Voer 'codex' uit in een terminal en volg de aanmeldstappen. Ververs of herstart de app daarna.",
antigravity_token_expired_title: "Antigravity-authenticatiefout",
antigravity_token_expired_body: "Open Antigravity en meld je opnieuw aan. Ververs of herstart de app daarna.",
codex_window_title: "Codex-gebruiksmonitor",
antigravity_window_title: "Antigravity-gebruiksmonitor",
second_suffix: "s",
};
4 changes: 4 additions & 0 deletions src/localization/english.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Models",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Settings",
start_with_windows: "Start with Windows",
reset_position: "Reset Position",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "Run 'claude' in a terminal, then use '/login' and follow the prompts. After that, refresh or restart this app.",
codex_token_expired_title: "Codex Auth Error",
codex_token_expired_body: "Run 'codex' in a terminal and follow the sign-in prompts. After that, refresh or restart this app.",
antigravity_token_expired_title: "Antigravity Auth Error",
antigravity_token_expired_body: "Open Antigravity and sign in again. After that, refresh or restart this app.",
codex_window_title: "Codex Usage Monitor",
antigravity_window_title: "Antigravity Usage Monitor",
second_suffix: "s",
};
4 changes: 4 additions & 0 deletions src/localization/french.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Modeles",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Paramètres",
start_with_windows: "Démarrer avec Windows",
reset_position: "Réinitialiser la position",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
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_title: "Erreur d'authentification Codex",
codex_token_expired_body: "Executez 'codex' dans un terminal et suivez les instructions de connexion. Ensuite, actualisez ou redemarrez cette application.",
antigravity_token_expired_title: "Erreur d'authentification Antigravity",
antigravity_token_expired_body: "Ouvrez Antigravity et reconnectez-vous. Ensuite, actualisez ou redemarrez cette application.",
codex_window_title: "Moniteur d'utilisation Codex",
antigravity_window_title: "Moniteur d'utilisation Antigravity",
second_suffix: "s",
};
4 changes: 4 additions & 0 deletions src/localization/german.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Modelle",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Einstellungen",
start_with_windows: "Mit Windows starten",
reset_position: "Position zurücksetzen",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
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_title: "Codex-Authentifizierungsfehler",
codex_token_expired_body: "Fuhren Sie 'codex' in einem Terminal aus und folgen Sie den Anmeldeanweisungen. Aktualisieren oder starten Sie diese App anschliessend neu.",
antigravity_token_expired_title: "Antigravity-Authentifizierungsfehler",
antigravity_token_expired_body: "Offnen Sie Antigravity und melden Sie sich erneut an. Aktualisieren oder starten Sie diese App anschliessend neu.",
codex_window_title: "Codex-Nutzungsmonitor",
antigravity_window_title: "Antigravity-Nutzungsmonitor",
second_suffix: "s",
};
4 changes: 4 additions & 0 deletions src/localization/japanese.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "モデル",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "設定",
start_with_windows: "Windows と同時に開始",
reset_position: "位置をリセット",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "ターミナルで 'claude' を実行し、'/login' を使って案内に従ってください。その後、このアプリを更新するか再起動してください。",
codex_token_expired_title: "Codex 認証エラー",
codex_token_expired_body: "ターミナルで 'codex' を実行し、サインインの案内に従ってください。その後、このアプリを更新または再起動してください。",
antigravity_token_expired_title: "Antigravity 認証エラー",
antigravity_token_expired_body: "Antigravity を開いて再度サインインしてください。その後、このアプリを更新するか再起動してください。",
codex_window_title: "Codex 使用量モニター",
antigravity_window_title: "Antigravity 使用量モニター",
second_suffix: "秒",
};
4 changes: 4 additions & 0 deletions src/localization/korean.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "모델",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "설정",
start_with_windows: "Windows 시작 시 자동 실행",
reset_position: "위치 초기화",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "터미널에서 'claude'를 실행한 다음 '/login'을 사용하고 안내에 따라 진행하세요. 그런 다음 이 앱을 새로 고치거나 다시 시작하세요.",
codex_token_expired_title: "Codex 인증 오류",
codex_token_expired_body: "터미널에서 'codex'를 실행하고 로그인 안내를 따르세요. 그런 다음 이 앱을 새로 고치거나 다시 시작하세요.",
antigravity_token_expired_title: "Antigravity 인증 오류",
antigravity_token_expired_body: "Antigravity를 열고 다시 로그인하세요. 그런 다음 이 앱을 새로 고치거나 다시 시작하세요.",
codex_window_title: "Codex 사용량 모니터",
antigravity_window_title: "Antigravity 사용량 모니터",
second_suffix: "초",
};
8 changes: 6 additions & 2 deletions src/localization/mod.rs
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ mod french;
mod german;
mod japanese;
mod korean;
mod portuguese_brazil;
mod russian;
mod spanish;
mod traditional_chinese;
mod russian;
mod portuguese_brazil;

use windows::core::PWSTR;
use windows::Win32::Globalization::{
Expand Down Expand Up @@ -147,6 +147,7 @@ pub struct Strings {
pub models: &'static str,
pub claude_code_model: &'static str,
pub codex_model: &'static str,
pub antigravity_model: &'static str,
pub settings: &'static str,
pub start_with_windows: &'static str,
pub reset_position: &'static str,
Expand Down Expand Up @@ -176,7 +177,10 @@ pub struct Strings {
pub token_expired_body: &'static str,
pub codex_token_expired_title: &'static str,
pub codex_token_expired_body: &'static str,
pub antigravity_token_expired_title: &'static str,
pub antigravity_token_expired_body: &'static str,
pub codex_window_title: &'static str,
pub antigravity_window_title: &'static str,
}

pub fn resolve_language(language_override: Option<LanguageId>) -> LanguageId {
Expand Down
4 changes: 4 additions & 0 deletions src/localization/portuguese_brazil.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Modelos",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Configurações",
start_with_windows: "Iniciar com o Windows",
reset_position: "Redefinir Posição",
Expand Down Expand Up @@ -42,5 +43,8 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "Execute 'claude' em um terminal, use '/login' e siga as instruções. Depois disso, atualize ou reinicie este aplicativo.",
codex_token_expired_title: "Erro de Autenticação do Codex",
codex_token_expired_body: "Execute 'codex' em um terminal e siga as instruções de login. Depois disso, atualize ou reinicie este aplicativo.",
antigravity_token_expired_title: "Erro de Autenticação do Antigravity",
antigravity_token_expired_body: "Abra o Antigravity e entre novamente. Depois disso, atualize ou reinicie este aplicativo.",
codex_window_title: "Monitor de uso do Codex",
antigravity_window_title: "Monitor de uso do Antigravity",
};
6 changes: 5 additions & 1 deletion src/localization/russian.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Модели",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Настройки",
start_with_windows: "Запускать вместе с Windows",
reset_position: "Сбросить позицию",
Expand Down Expand Up @@ -42,5 +43,8 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "Запустите 'claude' в терминале, затем используйте '/login' и следуйте инструкциям. После этого обновите или перезапустите приложение.",
codex_token_expired_title: "Ошибка авторизации Codex",
codex_token_expired_body: "Запустите 'codex' в терминале и следуйте инструкциям для входа. После этого обновите или перезапустите приложение.",
antigravity_token_expired_title: "Ошибка авторизации Antigravity",
antigravity_token_expired_body: "Откройте Antigravity и войдите снова. После этого обновите или перезапустите приложение.",
codex_window_title: "Монитор использования Codex",
};
antigravity_window_title: "Монитор использования Antigravity",
};
4 changes: 4 additions & 0 deletions src/localization/spanish.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "Modelos",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "Configuración",
start_with_windows: "Iniciar con Windows",
reset_position: "Restablecer posición",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "Ejecuta 'claude' en una terminal, luego usa '/login' y sigue las indicaciones. Después, actualiza o reinicia esta aplicación.",
codex_token_expired_title: "Error de autenticacion de Codex",
codex_token_expired_body: "Ejecuta 'codex' en una terminal y sigue las indicaciones de inicio de sesion. Despues, actualiza o reinicia esta aplicacion.",
antigravity_token_expired_title: "Error de autenticacion de Antigravity",
antigravity_token_expired_body: "Abre Antigravity e inicia sesion otra vez. Despues, actualiza o reinicia esta aplicacion.",
codex_window_title: "Monitor de uso de Codex",
antigravity_window_title: "Monitor de uso de Antigravity",
second_suffix: "s",
};
4 changes: 4 additions & 0 deletions src/localization/traditional_chinese.rs
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ pub(super) const STRINGS: Strings = Strings {
models: "模型",
claude_code_model: "Claude Code",
codex_model: "Codex",
antigravity_model: "Antigravity",
settings: "設定",
start_with_windows: "開機時啟動",
reset_position: "重置位置",
Expand Down Expand Up @@ -41,6 +42,9 @@ pub(super) const STRINGS: Strings = Strings {
token_expired_body: "請在終端機中執行 'claude',然後使用 '/login' 並依照提示操作。完成後,請重新整理或重新啟動此應用程式。",
codex_token_expired_title: "Codex 驗證錯誤",
codex_token_expired_body: "請在終端機中執行 'codex',並依照登入提示操作。完成後,請重新整理或重新啟動此應用程式。",
antigravity_token_expired_title: "Antigravity 驗證錯誤",
antigravity_token_expired_body: "請開啟 Antigravity 並重新登入。完成後,請重新整理或重新啟動此應用程式。",
codex_window_title: "Codex 使用量監控",
antigravity_window_title: "Antigravity 使用量監控",
second_suffix: "秒",
};
5 changes: 1 addition & 4 deletions src/main.rs
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,7 @@ fn main() {
let diagnose_enabled = args.iter().any(|arg| arg == "--diagnose");
if diagnose_enabled {
match diagnose::init() {
Ok(path) => diagnose::log(format!(
"startup args={args:?} log_path={}",
path.display()
)),
Ok(path) => diagnose::log(format!("startup args={args:?} log_path={}", path.display())),
Err(error) => {
// Logging may not be available yet, but keep startup behavior unchanged.
let _ = error;
Expand Down
1 change: 1 addition & 0 deletions src/models.rs
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,5 @@ pub struct UsageData {
pub struct AppUsageData {
pub claude_code: Option<UsageData>,
pub codex: Option<UsageData>,
pub antigravity: Option<UsageData>,
}
Loading