release: 0.28.0 — full Windows support

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: aqua5230

CHANGELOG.md

@@ -5,6 +5,17 @@
 All notable changes to usage are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.28.0] - 2026-07-15
+
+### Added
+- **Full Windows support**: `usage` now runs natively on Windows, including the TUI, Claude Code status-line hook, and Codex history parsing.
+- **Windows system tray UI**: a dynamic tray icon shows the Claude quota percentage; its tooltip summarizes Claude and Codex windows. Left-click opens the same 11 HTML theme panels used on macOS through WebView2, while the right-click menu offers panel switching, refresh, launch at login, update checks, and quit.
+- **Portable Windows release**: GitHub Releases now include `usage-windows.zip`, containing `usage.exe` for unzip-and-run use. It requires the Microsoft Edge WebView2 Runtime, which is normally already present on Windows 10 and 11.
+
+### Changed
+- Windows packaging and CI now use PyInstaller and `windows-latest` for both checks and release artifacts. The optional `windows` extra installs pystray, pywebview, and Pillow; macOS-only PyObjC dependencies are guarded by a Darwin platform marker.
+- Status-line hook file locking and generated hook-command quoting are platform-aware, so they work on Windows as well as macOS.
+
 ## [0.27.4] - 2026-07-15
 
 ### Fixed

CHANGELOG.zh-TW.md

@@ -4,6 +4,17 @@
 
 本檔記錄 usage 所有重要變更。格式參考 [Keep a Changelog](https://keepachangelog.com/)。
 
+## [0.28.0] - 2026-07-15
+
+### 新增
+- **完整支援 Windows**：`usage` 現在可原生在 Windows 執行，包含 TUI、Claude Code 狀態列 hook 與 Codex 記錄解析。
+- **Windows 系統匣 UI**：動態托盤圖示會顯示 Claude 額度百分比；提示文字摘要 Claude 與 Codex 的各視窗。左鍵透過 WebView2 開啟與 macOS 相同的 11 款 HTML 主題面板，右鍵選單可切換面板、重新整理、設定開機自啟、檢查更新與結束。
+- **免安裝 Windows 發行檔**：GitHub Releases 現在提供 `usage-windows.zip`，內含解壓即可執行的 `usage.exe`。需要 Microsoft Edge WebView2 Runtime；Windows 10 與 11 通常已內建。
+
+### 變更
+- Windows 打包與 CI 現在以 PyInstaller 和 `windows-latest` 產生檢查與發行產物。選用的 `windows` extra 安裝 pystray、pywebview、Pillow；僅限 macOS 的 PyObjC 依賴改由 Darwin 平台標記保護。
+- 狀態列 hook 的檔案鎖定與產生的 hook 指令引號已改為平台感知，因此 Windows 與 macOS 都能運作。
+
 ## [0.27.4] - 2026-07-15
 
 ### 修正

README.ja.md

@@ -4,16 +4,16 @@
 
 # usage
 
-### macOSのメニューバーでClaude Code、Codex、Antigravityのクォータを確認。
+### macOSのメニューバーとWindowsのシステムトレイでClaude Code、Codex、Antigravityのクォータを確認。
 
-作業中もClaude Code、Codex、Antigravityのクォータを確認できます。`usage` はセッション上限、週ごとの上限、コストの状況をmacOSのメニューバーに表示し、セッションが中断される前に使用量を管理できるようにします。
+作業中もClaude Code、Codex、Antigravityのクォータを確認できます。`usage` はセッション上限、週ごとの上限、コストの状況をmacOSのメニューバーまたはWindowsのシステムトレイに表示し、セッションが中断される前に使用量を管理できるようにします。
 
 [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [English](README.md) · 日本語 · [한국어](README.ko.md)  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [公式サイト](https://aqua5230.github.io/usage/)
 
 [![CI](https://github.com/aqua5230/usage/actions/workflows/check.yml/badge.svg)](https://github.com/aqua5230/usage/actions/workflows/check.yml)
 [![最新リリース](https://img.shields.io/github/v/release/aqua5230/usage)](https://github.com/aqua5230/usage/releases/latest)
 [![Python](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/)
-[![プラットフォーム](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![プラットフォーム](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/aqua5230/usage/releases/latest)
 [![ライセンス：AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![OpenSSF ベストプラクティス](https://www.bestpractices.dev/projects/13538/badge)](https://www.bestpractices.dev/projects/13538)
 
@@ -73,7 +73,7 @@ Applicationsフォルダに自動でインストールされます。Gatekeeper
 
 ## 必要環境
 
-- macOS
+- macOS または Windows 10/11
 - Claude Code、Codex、またはAntigravityを少なくとも一度使用済みであること（ローカル使用量データが存在するため）。
 - （ソースから実行する場合のみ）Python 3.13。
 
@@ -89,12 +89,20 @@ brew install --cask aqua5230/usage/usage
 
 *（初回起動：Finderで `usage.app` を右クリック → **Open** を選び、Gatekeeperを通します）。*
 
-### 2. Appをダウンロード
+### 2. macOS版Appをダウンロード
 
 1. [GitHub Releasesページ](https://github.com/aqua5230/usage/releases/latest)から最新の `usage.app.zip` をダウンロードします。
 2. 展開し、`usage.app` をApplicationsフォルダにドラッグします。
 3. 初回起動：Finderで `usage.app` を右クリック → **Open** → Openを確認します。
 
+## Windows対応
+
+Windowsでも主要機能をすべてネイティブで利用できます。TUI、Claude Codeのステータスラインhook、Codex履歴の解析に対応しています。[最新のGitHub Release](https://github.com/aqua5230/usage/releases/latest)から`usage-windows.zip`をダウンロードし、展開して`usage.exe`を実行してください。インストールは不要です。システムトレイUIにはMicrosoft Edge WebView2 Runtimeが必要ですが、通常はWindows 10/11に含まれています。
+
+システムトレイのアイコンはClaudeのクォータ率に合わせて更新され、ツールチップにはClaudeとCodexの各ウィンドウの概要が表示されます。左クリックでWebView2上にmacOSと同じ11種類のHTMLパネル（Classicと10テーマ）を開き、右クリックではパネル切替、更新、ログイン時に起動、更新確認、終了を行えます。
+
+Windowsでの相違点：パネルはトレイアイコンの隣ではなく作業領域の右下に開きます。更新通知はシステムのYes/Noダイアログです。AI Talent MarketパネルはmacOS専用です。
+
 ### 初回起動：ステータスラインを設定
 
 Codexを使用したことがある場合、`usage` はその履歴を自動で取得します。Claude Codeの場合は、アプリのポップオーバーで **「Set Up Status Line」** ボタンをクリックし、同期hookをインストールしてください。

README.ko.md

@@ -4,16 +4,16 @@
 
 # usage
 
-### macOS 메뉴 막대에서 Claude Code, Codex, Antigravity 할당량을 확인하세요.
+### macOS 메뉴 막대와 Windows 시스템 트레이에서 Claude Code, Codex, Antigravity 할당량을 확인하세요.
 
-작업하는 동안 Claude Code, Codex, Antigravity 할당량을 계속 확인하세요. `usage`는 세션 한도, 주간 한도, 비용 정보를 macOS 메뉴 막대에 표시하므로 세션이 중단되기 전에 사용량을 관리할 수 있습니다.
+작업하는 동안 Claude Code, Codex, Antigravity 할당량을 계속 확인하세요. `usage`는 세션 한도, 주간 한도, 비용 정보를 macOS 메뉴 막대 또는 Windows 시스템 트레이에 표시하므로 세션이 중단되기 전에 사용량을 관리할 수 있습니다.
 
 [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [English](README.md) · [日本語](README.ja.md) · 한국어  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [공식 사이트](https://aqua5230.github.io/usage/)
 
 [![CI](https://github.com/aqua5230/usage/actions/workflows/check.yml/badge.svg)](https://github.com/aqua5230/usage/actions/workflows/check.yml)
 [![최신 릴리스](https://img.shields.io/github/v/release/aqua5230/usage)](https://github.com/aqua5230/usage/releases/latest)
 [![Python](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/)
-[![플랫폼](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![플랫폼](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/aqua5230/usage/releases/latest)
 [![라이선스: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![OpenSSF 모범 사례](https://www.bestpractices.dev/projects/13538/badge)](https://www.bestpractices.dev/projects/13538)
 
@@ -73,7 +73,7 @@ Applications 폴더에 자동으로 설치됩니다. Gatekeeper를 통과하려
 
 ## 요구 사항
 
-- macOS
+- macOS 또는 Windows 10/11
 - Claude Code, Codex 또는 Antigravity를 한 번 이상 사용한 적이 있어야 합니다(로컬 사용량 데이터가 있어야 함).
 - (소스 실행만 해당) Python 3.13.
 
@@ -89,12 +89,20 @@ brew install --cask aqua5230/usage/usage
 
 *(첫 실행: Finder에서 `usage.app`을 마우스 오른쪽 버튼으로 클릭 → **Open**을 선택해 Gatekeeper를 통과합니다.)*
 
-### 2. App 다운로드
+### 2. macOS용 App 다운로드
 
 1. [GitHub Releases 페이지](https://github.com/aqua5230/usage/releases/latest)에서 최신 `usage.app.zip`을 다운로드합니다.
 2. 압축을 풀고 `usage.app`을 Applications 폴더로 드래그합니다.
 3. 첫 실행: Finder에서 `usage.app`을 마우스 오른쪽 버튼으로 클릭 → **Open** → Open을 확인합니다.
 
+## Windows 지원
+
+Windows에서도 핵심 기능을 모두 네이티브로 사용할 수 있습니다. TUI, Claude Code 상태 줄 hook, Codex 기록 분석을 지원합니다.[최신 GitHub Release](https://github.com/aqua5230/usage/releases/latest)에서 `usage-windows.zip`을 내려받아 압축을 풀고 `usage.exe`를 실행하면 됩니다. 설치는 필요하지 않습니다. 시스템 트레이 UI에는 Microsoft Edge WebView2 Runtime이 필요하며, 보통 Windows 10/11에 이미 포함되어 있습니다.
+
+시스템 트레이 아이콘은 Claude 할당량 비율에 따라 업데이트되고, 도구 설명에는 Claude와 Codex의 각 창 요약이 표시됩니다. 왼쪽 클릭하면 WebView2에서 macOS와 같은 11개 HTML 패널(Classic과 10개 테마)을 열고, 오른쪽 클릭 메뉴에서는 패널 전환, 새로 고침, 로그인 시 실행, 업데이트 확인, 종료를 할 수 있습니다.
+
+Windows의 차이점: 패널은 트레이 아이콘 옆이 아니라 작업 영역 오른쪽 아래에 열립니다. 업데이트 알림은 시스템 Yes/No 대화 상자를 사용합니다. AI Talent Market 패널은 macOS 전용입니다.
+
 ### 첫 실행: 상태 줄 설정
 
 Codex를 사용한 적이 있다면 `usage`가 기록을 자동으로 가져옵니다. Claude Code의 경우 앱 팝오버에서 **"Set Up Status Line"** 버튼을 클릭하여 동기화 hook을 설치하세요.

README.md

@@ -4,16 +4,16 @@
 
 # usage
 
-### Quota visibility for Claude Code, Codex, and Antigravity, built into the macOS menu bar.
+### Quota visibility for Claude Code, Codex, and Antigravity, built into the macOS menu bar and Windows system tray.
 
-Keep Claude Code, Codex, and Antigravity quota in view while you work. `usage` puts session limits, weekly limits, and cost context in the macOS menu bar, so you can manage usage before it interrupts a session.
+Keep Claude Code, Codex, and Antigravity quota in view while you work. `usage` puts session limits, weekly limits, and cost context in the macOS menu bar or Windows system tray, so you can manage usage before it interrupts a session.
 
 [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · English · [日本語](README.ja.md) · [한국어](README.ko.md)  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [Landing page](https://aqua5230.github.io/usage/)
 
 [![CI](https://github.com/aqua5230/usage/actions/workflows/check.yml/badge.svg)](https://github.com/aqua5230/usage/actions/workflows/check.yml)
 [![Latest Release](https://img.shields.io/github/v/release/aqua5230/usage)](https://github.com/aqua5230/usage/releases/latest)
 [![Python](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/)
-[![Platform](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/aqua5230/usage/releases/latest)
 [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13538/badge)](https://www.bestpractices.dev/projects/13538)
 
@@ -73,7 +73,7 @@ It lands in your Applications folder automatically. Right-click **Open** once to
 
 ## Requirements
 
-- macOS
+- macOS or Windows 10/11
 - Claude Code, Codex, or Antigravity has been used at least once (so local usage data exists).
 - (Source runs only) Python 3.13.
 
@@ -89,12 +89,20 @@ brew install --cask aqua5230/usage/usage
 
 *(First launch: right-click `usage.app` in Finder → **Open** to pass Gatekeeper).*
 
-### 2. Download the App
+### 2. Download for macOS
 
 1. Download the latest `usage.app.zip` from the [GitHub Releases page](https://github.com/aqua5230/usage/releases/latest).
 2. Unzip it and drag `usage.app` into your Applications folder.
 3. First launch: in Finder, right-click `usage.app` → **Open** → confirm Open.
 
+## Windows Support
+
+Windows has the full core experience: the TUI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
+
+The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 11 HTML panels as macOS (Classic plus the ten themes) in WebView2. Right-click provides panel switching, refresh, launch at login, check for updates, and quit.
+
+Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog; and the AI Talent Market panel is macOS-only.
+
 ### First Launch: Set Up the Status Line
 
 If you've used Codex, `usage` picks up its history automatically. For Claude Code, click the **"Set Up Status Line"** button in the app popover to install the sync hook.

README.zh-CN.md

@@ -4,16 +4,16 @@
 
 # usage
 
-### 在 macOS 菜单栏中查看 Claude Code、Codex 和 Antigravity 配额。
+### 在 macOS 菜单栏和 Windows 系统托盘中查看 Claude Code、Codex 和 Antigravity 配额。
 
-工作时持续查看 Claude Code、Codex 和 Antigravity 配额。`usage` 将会话限额、每周限额和费用背景信息显示在 macOS 菜单栏中，让你能在配额中断会话前主动管理使用量。
+工作时持续查看 Claude Code、Codex 和 Antigravity 配额。`usage` 将会话限额、每周限额和费用背景信息显示在 macOS 菜单栏或 Windows 系统托盘中，让你能在配额中断会话前主动管理使用量。
 
 [繁體中文](README.zh-TW.md) · 简体中文 · [English](README.md) · [日本語](README.ja.md) · [한국어](README.ko.md)  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [官方介绍页](https://aqua5230.github.io/usage/)
 
 [![持续集成](https://github.com/aqua5230/usage/actions/workflows/check.yml/badge.svg)](https://github.com/aqua5230/usage/actions/workflows/check.yml)
 [![最新版本](https://img.shields.io/github/v/release/aqua5230/usage)](https://github.com/aqua5230/usage/releases/latest)
 [![Python](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/)
-[![平台](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
+[![平台](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/aqua5230/usage/releases/latest)
 [![许可证：AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 [![OpenSSF 最佳实践](https://www.bestpractices.dev/projects/13538/badge)](https://www.bestpractices.dev/projects/13538)
 
@@ -73,7 +73,7 @@ brew install --cask aqua5230/usage/usage
 
 ## 系统要求
 
-- macOS
+- macOS 或 Windows 10/11
 - 至少使用过一次 Claude Code、Codex 或 Antigravity（以便存在本地使用数据）。
 - （仅限源代码运行）Python 3.13。
 
@@ -89,12 +89,20 @@ brew install --cask aqua5230/usage/usage
 
 *（首次启动：在 Finder 中右键 `usage.app` → **Open** 以通过 Gatekeeper）。*
 
-### 2. 下载 App
+### 2. 下载 macOS App
 
 1. 从 [GitHub Releases 页面](https://github.com/aqua5230/usage/releases/latest)下载最新的 `usage.app.zip`。
 2. 解压后，将 `usage.app` 拖入 Applications 文件夹。
 3. 首次启动：在 Finder 中右键 `usage.app` → **Open** → 确认 Open。
 
+## Windows 支持
+
+Windows 原生支持完整核心功能：TUI、Claude Code 状态栏 hook 和 Codex 记录解析均可使用。从[最新 GitHub Release](https://github.com/aqua5230/usage/releases/latest)下载 `usage-windows.zip`，解压后直接运行 `usage.exe`，无需安装。系统托盘 UI 需要 Microsoft Edge WebView2 Runtime；Windows 10 和 11 通常已经内置。
+
+系统托盘图标会随 Claude 配额百分比更新；提示文字会汇总 Claude 和 Codex 的各个窗口。左键通过 WebView2 打开与 macOS 相同的 11 个 HTML 面板（Classic 加十个主题）；右键可切换面板、刷新、设置开机自启、检查更新和退出。
+
+Windows 的差异：面板显示在工作区右下角，而不是紧贴系统托盘图标；更新提示使用系统 Yes/No 对话框；AI 人才市场面板仅限 macOS。
+
 ### 首次启动：设置状态栏
 
 如果你用过 Codex，`usage` 会自动读取其历史记录。对于 Claude Code，请在应用弹出面板中点击 **“Set Up Status Line”** 按钮以安装同步 hook。