usage-cli 0.31.4__tar.gz → 0.31.6__tar.gz

{usage_cli-0.31.4 → usage_cli-0.31.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.31.4
+Version: 0.31.6
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -24,9 +24,9 @@ Dynamic: license-file
 
 # usage
 
-### Quota visibility for Claude Code, Codex, Antigravity, and Grok CLI, built into the macOS menu bar and Windows system tray.
+### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
 
-Running out of quota mid-session is expensive — especially during a long refactor or debugging run that depends on Claude Code. `usage` surfaces 5-hour and weekly limits *before* you hit the wall, and keeps them visible the whole time. There's no command to run and no page to open; the answer is just there, where you already look.
+`usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, colored from green to red. Hitting the limit halfway through a long refactor is a bad way to find out you were running low. Now you see it coming. There's nothing to run and no page to open.
 
 [繁體中文](docs/README.zh-TW.md) · [简体中文](docs/README.zh-CN.md) · English · [日本語](docs/README.ja.md) · [한국어](docs/README.ko.md)  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [Landing page](https://aqua5230.github.io/usage/)
 
@@ -43,7 +43,9 @@ Running out of quota mid-session is expensive — especially during a long refac
   <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
 </p>
 
-Claude Code and Codex numbers are read passively from log files already on your machine, so **watching your quota never calls Anthropic or OpenAI's LLM APIs** and never costs you a token. Antigravity is the one exception: its quota comes from Google's official quota endpoint using the sign-in the Antigravity CLI already stores locally — a metadata call that doesn't consume your model quota either.
+Claude Code and Codex numbers come from log files already on your machine. Antigravity quota comes from Google's official quota endpoint, using the sign-in the Antigravity CLI already stores locally.
+
+`usage` also helps you spend less. The status line warns you before your context window bloats or your prompt cache goes cold, and a Token Saver toggle keeps replies short. In an A/B test on real sessions, late replies stayed ~40% shorter instead of growing 84% longer.
 
 ## Quick Start
 
@@ -51,10 +53,10 @@ Claude Code and Codex numbers are read passively from log files already on your
 brew install --cask aqua5230/usage/usage
 ```
 
-**Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
-
 It lands in your Applications folder automatically. Open it once; if macOS 15 or later blocks it, go to System Settings → Privacy & Security, scroll down, and click **Open Anyway**. On macOS 14 or earlier, right-click **Open** once to pass Gatekeeper. Then click the menu bar icon. Prefer a direct download or want the full setup flow? See [Install](#install) below.
 
+**Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
+
 **Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
 
 ## What You Get
@@ -63,21 +65,22 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 - **Always-on Monitor:** Your quota lives in the menu bar, color-coded from green to red. Click when you want the full session, weekly, and per-project breakdown.
 - **Antigravity Support:** Antigravity (Gemini) session and weekly quota show up as a third card in every theme except World Cup 2026, which stays a two-team HUD. Numbers come straight from the official quota API, using the sign-in the Antigravity CLI already keeps on your machine — refreshed every few minutes, with live reset countdowns. Antigravity keeps two separate quota pools: the card shows Gemini by default, and tapping the `Gemini ⇄` tag next to the title switches it to Claude / GPT — the choice is remembered.
-- **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log — no network call. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
+- **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
 - **Muse Code Spending:** Muse Code's per-request tokens and cost count toward today's cost, project totals, the HTML report, and the `usage` CLI, read from its own local session logs. Muse keeps no local quota data, so there is no Muse quota card.
-- **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages — never an LLM usage API. Antigravity isn't covered; it has no public status page.
+- **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages. Antigravity isn't covered; it has no public status page.
 - **Context Nudges & Notifications:** When your context window hits 70% — or earlier when it is filling fast — the status line nudges you to `/clear` or `/compact` to prevent token waste. You can also opt-in to system notifications for quota limits and recoveries.
 - **Prompt Cache Health:** The status line shows Claude Code's prompt cache hit rate with a countdown to expiry, so you can tell at a glance whether finishing now still reuses the cached context or lets it go cold and re-sends everything. Once it has gone cold, the countdown turns into how many tokens your next message will re-cache. Needs Claude Code 2.1.251 or newer; on older versions the segment simply doesn't appear.
 - **Hide Sections:** Only use one or two of the tools? Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels completely with a single click.
 
 ### Workflow Helpers
 
-- **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Fully local, off by default.
+- **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
-- **Terminal Integration:** `usage status --json` hands your Claude Code and Codex quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar, no network call. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
+- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
+- **Terminal Integration:** `usage status --json` hands your Claude Code and Codex quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
 
-### AI Teamwork
+### Stay Current
 
 - **AI Update Daily:** Opens a daily-updated public [page](https://aqua5230.github.io/ai-updates/) covering Claude Code, Codex, and Antigravity, with the full history kept. Reviewed items get a plain-language summary in all five UI languages; unreviewed ones show the original source text.
 
@@ -88,20 +91,20 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 ### Experience & Customization
 
 - **16 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, Heart Monitor, and Catppuccin (official palette, all four flavors).
-- **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
+- **Place the Panel Anywhere:** Drag the panel from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
 
 ## Privacy & Data Sources
 
-- Claude Code and Codex numbers are read **only from local log files** on your machine; reading them **never calls Anthropic or OpenAI's LLM APIs**.
-- Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself only reads quota metadata and never consumes your model quota.
+- Claude Code and Codex numbers are read from local log files on your machine.
+- Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
 
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, or Antigravity has been used at least once (so local usage data exists).
+- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -167,21 +170,22 @@ Privacy policy: this program will not transfer any information to other networke
 Switch between **16 visual themes** directly from the UI:
 
 <p align="center">
-  <img src="docs/classic.en.png" width="32%" alt="Classic theme" />
-  <img src="docs/matrix.en.png" width="32%" alt="Matrix theme" />
-  <img src="docs/win95.en.png" width="32%" alt="Windows 95 theme" />
-  <img src="docs/newspaper.en.png" width="32%" alt="Newspaper theme" />
-  <img src="docs/cloud_observation.en.png" width="32%" alt="Cloud Observation theme" />
-  <img src="docs/aquarium.en.png" width="32%" alt="Midnight Aquarium theme" />
-  <img src="docs/prism_arcade.en.png" width="32%" alt="Prism Arcade theme" />
-  <img src="docs/stained_glass.en.png" width="32%" alt="Stained Glass theme" />
-  <img src="docs/origami.en.png" width="32%" alt="Origami theme" />
-  <img src="docs/black_hole.en.png" width="32%" alt="Black Hole theme" />
-  <img src="docs/lepidoptera.en.png" width="32%" alt="Lepidoptera theme" />
-  <img src="docs/migration.en.png" width="32%" alt="Migration theme" />
-  <img src="docs/catppuccin.en.png" width="32%" alt="Catppuccin theme" />
-  <img src="docs/sketchbook.en.png" width="32%" alt="Sketchbook theme" />
-  <img src="docs/heart_monitor.en.png" width="32%" alt="Heart Monitor theme" />
+  <img src="docs/classic.en.png" width="24%" alt="Classic theme" />
+  <img src="docs/matrix.en.png" width="24%" alt="Matrix theme" />
+  <img src="docs/win95.en.png" width="24%" alt="Windows 95 theme" />
+  <img src="docs/newspaper.en.png" width="24%" alt="Newspaper theme" />
+  <img src="docs/cloud_observation.en.png" width="24%" alt="Cloud Observation theme" />
+  <img src="docs/aquarium.en.png" width="24%" alt="Midnight Aquarium theme" />
+  <img src="docs/prism_arcade.en.png" width="24%" alt="Prism Arcade theme" />
+  <img src="docs/stained_glass.en.png" width="24%" alt="Stained Glass theme" />
+  <img src="docs/origami.en.png" width="24%" alt="Origami theme" />
+  <img src="docs/black_hole.en.png" width="24%" alt="Black Hole theme" />
+  <img src="docs/world_cup.en.png" width="24%" alt="World Cup 2026 theme" />
+  <img src="docs/lepidoptera.en.png" width="24%" alt="Lepidoptera theme" />
+  <img src="docs/migration.en.png" width="24%" alt="Migration theme" />
+  <img src="docs/catppuccin.en.png" width="24%" alt="Catppuccin theme" />
+  <img src="docs/sketchbook.en.png" width="24%" alt="Sketchbook theme" />
+  <img src="docs/heart_monitor.en.png" width="24%" alt="Heart Monitor theme" />
 </p>
 
 ## Troubleshooting
@@ -215,14 +219,13 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
-| No LLM API calls to read quota | ✅ | ✅ | ✅ |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit
 
 - You only live in the terminal and don't want another menu bar icon running in the background — a one-off CLI check fits better.
-- You don't use Claude Code, Codex, or Antigravity — there's no local usage data for `usage` to read.
-- You're on Linux — only macOS and Windows are supported today.
+- You don't use Claude Code, Codex, Antigravity, or Grok CLI — there's no local usage data for `usage` to read.
+- You want a menu bar on Linux. Only macOS and Windows have one today, though the terminal interface (`uvx usage-cli`) runs on Linux.
 
 ## Development
 

{usage_cli-0.31.4 → usage_cli-0.31.6}/README.md

@@ -4,9 +4,9 @@
 
 # usage
 
-### Quota visibility for Claude Code, Codex, Antigravity, and Grok CLI, built into the macOS menu bar and Windows system tray.
+### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
 
-Running out of quota mid-session is expensive — especially during a long refactor or debugging run that depends on Claude Code. `usage` surfaces 5-hour and weekly limits *before* you hit the wall, and keeps them visible the whole time. There's no command to run and no page to open; the answer is just there, where you already look.
+`usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, colored from green to red. Hitting the limit halfway through a long refactor is a bad way to find out you were running low. Now you see it coming. There's nothing to run and no page to open.
 
 [繁體中文](docs/README.zh-TW.md) · [简体中文](docs/README.zh-CN.md) · English · [日本語](docs/README.ja.md) · [한국어](docs/README.ko.md)  |  [Discussions](https://github.com/aqua5230/usage/discussions)  |  [Landing page](https://aqua5230.github.io/usage/)
 
@@ -23,7 +23,9 @@ Running out of quota mid-session is expensive — especially during a long refac
   <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
 </p>
 
-Claude Code and Codex numbers are read passively from log files already on your machine, so **watching your quota never calls Anthropic or OpenAI's LLM APIs** and never costs you a token. Antigravity is the one exception: its quota comes from Google's official quota endpoint using the sign-in the Antigravity CLI already stores locally — a metadata call that doesn't consume your model quota either.
+Claude Code and Codex numbers come from log files already on your machine. Antigravity quota comes from Google's official quota endpoint, using the sign-in the Antigravity CLI already stores locally.
+
+`usage` also helps you spend less. The status line warns you before your context window bloats or your prompt cache goes cold, and a Token Saver toggle keeps replies short. In an A/B test on real sessions, late replies stayed ~40% shorter instead of growing 84% longer.
 
 ## Quick Start
 
@@ -31,10 +33,10 @@ Claude Code and Codex numbers are read passively from log files already on your
 brew install --cask aqua5230/usage/usage
 ```
 
-**Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
-
 It lands in your Applications folder automatically. Open it once; if macOS 15 or later blocks it, go to System Settings → Privacy & Security, scroll down, and click **Open Anyway**. On macOS 14 or earlier, right-click **Open** once to pass Gatekeeper. Then click the menu bar icon. Prefer a direct download or want the full setup flow? See [Install](#install) below.
 
+**Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
+
 **Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
 
 ## What You Get
@@ -43,21 +45,22 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 - **Always-on Monitor:** Your quota lives in the menu bar, color-coded from green to red. Click when you want the full session, weekly, and per-project breakdown.
 - **Antigravity Support:** Antigravity (Gemini) session and weekly quota show up as a third card in every theme except World Cup 2026, which stays a two-team HUD. Numbers come straight from the official quota API, using the sign-in the Antigravity CLI already keeps on your machine — refreshed every few minutes, with live reset countdowns. Antigravity keeps two separate quota pools: the card shows Gemini by default, and tapping the `Gemini ⇄` tag next to the title switches it to Claude / GPT — the choice is remembered.
-- **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log — no network call. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
+- **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
 - **Muse Code Spending:** Muse Code's per-request tokens and cost count toward today's cost, project totals, the HTML report, and the `usage` CLI, read from its own local session logs. Muse keeps no local quota data, so there is no Muse quota card.
-- **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages — never an LLM usage API. Antigravity isn't covered; it has no public status page.
+- **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages. Antigravity isn't covered; it has no public status page.
 - **Context Nudges & Notifications:** When your context window hits 70% — or earlier when it is filling fast — the status line nudges you to `/clear` or `/compact` to prevent token waste. You can also opt-in to system notifications for quota limits and recoveries.
 - **Prompt Cache Health:** The status line shows Claude Code's prompt cache hit rate with a countdown to expiry, so you can tell at a glance whether finishing now still reuses the cached context or lets it go cold and re-sends everything. Once it has gone cold, the countdown turns into how many tokens your next message will re-cache. Needs Claude Code 2.1.251 or newer; on older versions the segment simply doesn't appear.
 - **Hide Sections:** Only use one or two of the tools? Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels completely with a single click.
 
 ### Workflow Helpers
 
-- **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Fully local, off by default.
+- **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
-- **Terminal Integration:** `usage status --json` hands your Claude Code and Codex quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar, no network call. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
+- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
+- **Terminal Integration:** `usage status --json` hands your Claude Code and Codex quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
 
-### AI Teamwork
+### Stay Current
 
 - **AI Update Daily:** Opens a daily-updated public [page](https://aqua5230.github.io/ai-updates/) covering Claude Code, Codex, and Antigravity, with the full history kept. Reviewed items get a plain-language summary in all five UI languages; unreviewed ones show the original source text.
 
@@ -68,20 +71,20 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 ### Experience & Customization
 
 - **16 Visual Themes:** Switch between panel styles including Default, Matrix, Windows 95, Vintage Newspaper, Cloud Observation, Midnight Aquarium, Prism Arcade, Black Hole, World Cup 2026, Lepidoptera, Migration, Stained Glass, Origami, Sketchbook, Heart Monitor, and Catppuccin (official palette, all four flavors).
-- **Place the Panel Anywhere:** The panel is no longer pinned under the menu bar icon. Drag it from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
+- **Place the Panel Anywhere:** Drag the panel from any empty spot to wherever you want it, and it reopens there next time. It stays put when another app takes focus — a second click on the menu bar icon, or Escape, closes it.
 - **Drag to Reorder:** Grab any quota card and drag it up or down to swap the order — the arrangement is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **Automatic Localization:** UI text is available in Traditional Chinese, Simplified Chinese, English, Japanese, and Korean, automatically matching your system settings.
 
 ## Privacy & Data Sources
 
-- Claude Code and Codex numbers are read **only from local log files** on your machine; reading them **never calls Anthropic or OpenAI's LLM APIs**.
-- Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself only reads quota metadata and never consumes your model quota.
+- Claude Code and Codex numbers are read from local log files on your machine.
+- Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
 
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, or Antigravity has been used at least once (so local usage data exists).
+- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -147,21 +150,22 @@ Privacy policy: this program will not transfer any information to other networke
 Switch between **16 visual themes** directly from the UI:
 
 <p align="center">
-  <img src="docs/classic.en.png" width="32%" alt="Classic theme" />
-  <img src="docs/matrix.en.png" width="32%" alt="Matrix theme" />
-  <img src="docs/win95.en.png" width="32%" alt="Windows 95 theme" />
-  <img src="docs/newspaper.en.png" width="32%" alt="Newspaper theme" />
-  <img src="docs/cloud_observation.en.png" width="32%" alt="Cloud Observation theme" />
-  <img src="docs/aquarium.en.png" width="32%" alt="Midnight Aquarium theme" />
-  <img src="docs/prism_arcade.en.png" width="32%" alt="Prism Arcade theme" />
-  <img src="docs/stained_glass.en.png" width="32%" alt="Stained Glass theme" />
-  <img src="docs/origami.en.png" width="32%" alt="Origami theme" />
-  <img src="docs/black_hole.en.png" width="32%" alt="Black Hole theme" />
-  <img src="docs/lepidoptera.en.png" width="32%" alt="Lepidoptera theme" />
-  <img src="docs/migration.en.png" width="32%" alt="Migration theme" />
-  <img src="docs/catppuccin.en.png" width="32%" alt="Catppuccin theme" />
-  <img src="docs/sketchbook.en.png" width="32%" alt="Sketchbook theme" />
-  <img src="docs/heart_monitor.en.png" width="32%" alt="Heart Monitor theme" />
+  <img src="docs/classic.en.png" width="24%" alt="Classic theme" />
+  <img src="docs/matrix.en.png" width="24%" alt="Matrix theme" />
+  <img src="docs/win95.en.png" width="24%" alt="Windows 95 theme" />
+  <img src="docs/newspaper.en.png" width="24%" alt="Newspaper theme" />
+  <img src="docs/cloud_observation.en.png" width="24%" alt="Cloud Observation theme" />
+  <img src="docs/aquarium.en.png" width="24%" alt="Midnight Aquarium theme" />
+  <img src="docs/prism_arcade.en.png" width="24%" alt="Prism Arcade theme" />
+  <img src="docs/stained_glass.en.png" width="24%" alt="Stained Glass theme" />
+  <img src="docs/origami.en.png" width="24%" alt="Origami theme" />
+  <img src="docs/black_hole.en.png" width="24%" alt="Black Hole theme" />
+  <img src="docs/world_cup.en.png" width="24%" alt="World Cup 2026 theme" />
+  <img src="docs/lepidoptera.en.png" width="24%" alt="Lepidoptera theme" />
+  <img src="docs/migration.en.png" width="24%" alt="Migration theme" />
+  <img src="docs/catppuccin.en.png" width="24%" alt="Catppuccin theme" />
+  <img src="docs/sketchbook.en.png" width="24%" alt="Sketchbook theme" />
+  <img src="docs/heart_monitor.en.png" width="24%" alt="Heart Monitor theme" />
 </p>
 
 ## Troubleshooting
@@ -195,14 +199,13 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
-| No LLM API calls to read quota | ✅ | ✅ | ✅ |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit
 
 - You only live in the terminal and don't want another menu bar icon running in the background — a one-off CLI check fits better.
-- You don't use Claude Code, Codex, or Antigravity — there's no local usage data for `usage` to read.
-- You're on Linux — only macOS and Windows are supported today.
+- You don't use Claude Code, Codex, Antigravity, or Grok CLI — there's no local usage data for `usage` to read.
+- You want a menu bar on Linux. Only macOS and Windows have one today, though the terminal interface (`uvx usage-cli`) runs on Linux.
 
 ## Development
 

{usage_cli-0.31.4 → usage_cli-0.31.6}/i18n.json

@@ -104,7 +104,7 @@
     "grok_stale_tooltip": "資料來自 Grok CLI 本機 log，不是即時 API；請最近執行過 grok 指令後再查看，才會更新。",
     "codex_stale_minutes": "約 {minutes} 分鐘前",
     "codex_stale_hours": "約 {hours} 小時前",
-    "codex_stale_tooltip": "Claude 有即時回報所以很準；Codex 沒有，usage 只能讀它本機偶爾留下的紀錄，可能比實際略舊。我們刻意不連網去補（連網會多燒你的 token）——繼續在終端機跑 Codex 就會自動更新。",
+    "codex_stale_tooltip": "Claude 有即時回報所以很準；Codex 沒有，usage 會讀它本機偶爾留下的紀錄，可能比實際略舊。繼續在終端機跑 Codex 就會自動更新。",
     "history_load_error_file": "讀不到使用紀錄檔",
     "history_load_error_parse": "使用紀錄格式異常",
     "history_load_error_unknown": "使用紀錄暫時無法讀取",
@@ -532,7 +532,7 @@
     "grok_stale_tooltip": "Data comes from Grok CLI's local log, not a live API. Run a grok command recently for it to update.",
     "codex_stale_minutes": "about {minutes} minutes ago",
     "codex_stale_hours": "about {hours} hours ago",
-    "codex_stale_tooltip": "Claude is accurate because it reports in real time; Codex does not, so usage can only read the local records it leaves occasionally, which may be slightly older than reality. We intentionally do not go online to fill the gap (that would burn more of your tokens) — keep running Codex in the terminal and it will update automatically.",
+    "codex_stale_tooltip": "Claude is accurate because it reports in real time; Codex does not, so usage reads the local records it leaves occasionally, which may be slightly older than reality. Keep running Codex in the terminal and it will update automatically.",
     "history_load_error_file": "Couldn't read usage files",
     "history_load_error_parse": "Usage data format issue",
     "history_load_error_unknown": "Usage data temporarily unavailable",
@@ -960,7 +960,7 @@
     "grok_stale_tooltip": "资料来自 Grok CLI 本地日志，不是即时 API；请最近运行过 grok 指令后再查看，才会更新。",
     "codex_stale_minutes": "约 {minutes} 分钟前",
     "codex_stale_hours": "约 {hours} 小时前",
-    "codex_stale_tooltip": "Claude 有实时回报所以很准；Codex 没有，usage 只能读取它本机偶尔留下的记录，可能比实际略旧。我们刻意不联网去补（联网会多消耗你的 token）——继续在终端运行 Codex 就会自动更新。",
+    "codex_stale_tooltip": "Claude 有实时回报所以很准；Codex 没有，usage 会读取它本机偶尔留下的记录，可能比实际略旧。继续在终端运行 Codex 就会自动更新。",
     "history_load_error_file": "读不到使用记录文件",
     "history_load_error_parse": "使用记录格式异常",
     "history_load_error_unknown": "使用记录暂时无法读取",
@@ -1388,7 +1388,7 @@
     "grok_stale_tooltip": "データは Grok CLI のローカルログから読み取るもので、リアルタイム API ではありません。更新するには最近 grok コマンドを実行してください。",
     "codex_stale_minutes": "約 {minutes} 分前",
     "codex_stale_hours": "約 {hours} 時間前",
-    "codex_stale_tooltip": "Claude はリアルタイムに報告するので正確です。Codex にはそれがないため、usage は Codex がローカルに時々残す記録だけを読み取り、実際より少し古い場合があります。補うために意図的にネット接続はしません（接続するとあなたの token を余分に消費します）——ターミナルで Codex を使い続けると自動的に更新されます。",
+    "codex_stale_tooltip": "Claude はリアルタイムに報告するので正確です。Codex にはそれがないため、usage は Codex がローカルに時々残す記録を読み取り、実際より少し古い場合があります。ターミナルで Codex を使い続けると自動的に更新されます。",
     "history_load_error_file": "使用履歴ファイルを読み込めません",
     "history_load_error_parse": "使用履歴データの形式に問題があります",
     "history_load_error_unknown": "使用履歴データを一時的に取得できません",
@@ -1816,7 +1816,7 @@
     "grok_stale_tooltip": "데이터는 Grok CLI의 로컬 로그에서 읽으며 실시간 API가 아닙니다. 업데이트하려면 최근에 grok 명령을 실행하세요.",
     "codex_stale_minutes": "약 {minutes}분 전",
     "codex_stale_hours": "약 {hours}시간 전",
-    "codex_stale_tooltip": "Claude는 실시간으로 보고하므로 정확합니다. Codex는 그렇지 않아 usage가 Codex가 로컬에 가끔 남기는 기록만 읽을 수 있고, 실제보다 조금 오래된 값일 수 있습니다. 우리는 이를 보완하려고 일부러 온라인 연결을 하지 않습니다(연결하면 token을 더 소비하게 됩니다)——터미널에서 Codex를 계속 실행하면 자동으로 업데이트됩니다.",
+    "codex_stale_tooltip": "Claude는 실시간으로 보고하므로 정확합니다. Codex는 그렇지 않아 usage가 Codex가 로컬에 가끔 남기는 기록을 읽으며, 실제보다 조금 오래된 값일 수 있습니다. 터미널에서 Codex를 계속 실행하면 자동으로 업데이트됩니다.",
     "history_load_error_file": "사용 기록 파일을 읽을 수 없습니다",
     "history_load_error_parse": "사용 기록 형식에 문제가 있습니다",
     "history_load_error_unknown": "사용 기록을 일시적으로 불러올 수 없습니다",

{usage_cli-0.31.4 → usage_cli-0.31.6}/installer/setup_hook.py

@@ -86,7 +86,7 @@ PREV_SL_KEY = "previousStatusLine"
 # Where the status-line switch parks the live statusLine while it is off, so it
 # never overwrites the pre-install backup under PREV_SL_KEY.
 DISABLED_SL_KEY = "disabledStatusLine"
-HOOK_VERSION = "1.7"
+HOOK_VERSION = "1.8"
 FORWARDER_VERSION = "1.1"
 # Antigravity's Go runner hands its status-line command to cmd.exe unquoted, so
 # every character cmd.exe treats specially has to be kept out of the path.

{usage_cli-0.31.4 → usage_cli-0.31.6}/pricing.py

@@ -527,6 +527,12 @@ def _fallback_pricing() -> PricingTable:
             "cache_creation_input_token_cost": 2.5e-6,
             "cache_read_input_token_cost": 0.2e-6,
         },
+        "gpt-6.1-sol": {
+            "input_cost_per_token": 2e-6,
+            "output_cost_per_token": 10e-6,
+            "cache_creation_input_token_cost": 2.5e-6,
+            "cache_read_input_token_cost": 0.1e-6,
+        },
         "gpt-6-luna": {
             "input_cost_per_token": 0.1e-6,
             "output_cost_per_token": 0.5e-6,

{usage_cli-0.31.4 → usage_cli-0.31.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usage-cli"
-version = "0.31.4"
+version = "0.31.6"
 description = "usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）"
 readme = "README.md"
 requires-python = ">=3.13"

{usage_cli-0.31.4 → usage_cli-0.31.6}/tests/test_usage_statusline.py

@@ -697,7 +697,7 @@ def test_render_outputs_multiline_colored_statusline(
     assert "$" not in output  # cost line removed in v0.10.0
 
 
-def test_render_shows_prompt_cache_hit_with_countdown(
+def test_render_shows_prompt_cache_hit_without_countdown(
     monkeypatch: pytest.MonkeyPatch,
 ) -> None:
     monkeypatch.setenv("TT_LANG", "zh_TW")
@@ -708,10 +708,8 @@ def test_render_shows_prompt_cache_hit_with_countdown(
         "cost": {"total_duration_ms": 720000},
         "prompt_cache": {
             "caching_observed": True,
-            "warm": True,
             "hit_ratio": 0.9072975151245158,
             "expires_at": now.timestamp() + 43 * 60,
-            "recache_tokens_if_cold": 180_000,
         },
     }
 
@@ -720,90 +718,10 @@ def test_render_shows_prompt_cache_hit_with_countdown(
     line3 = output.splitlines()[0]
     assert "快取:" in line3
     assert "91%" in line3
-    assert "(剩43min)" in line3
-    assert "已冷" not in line3
+    assert "43min" not in line3
     assert "\033[2m\033[38;5;111m" in line3
 
 
-@pytest.mark.parametrize(
-    ("lang", "warm", "expires_offset", "expected"),
-    [
-        ("zh-TW", False, -1, "已冷·下輪重寫 180k"),
-        ("en", False, -1, "cold·re-cache 180k"),
-        ("zh-TW", None, -1, "已冷·下輪重寫 180k"),
-        ("zh-TW", True, 0, "已冷·下輪重寫 180k"),
-        ("zh-TW", False, 60, "已冷·下輪重寫 180k"),
-    ],
-)
-def test_render_shows_recache_tokens_when_prompt_cache_is_cold(
-    monkeypatch: pytest.MonkeyPatch,
-    lang: str,
-    warm: bool | None,
-    expires_offset: int,
-    expected: str,
-) -> None:
-    monkeypatch.setenv("USAGE_LANG", lang)
-    monkeypatch.setattr(usage_statusline, "get_width", lambda: 116)
-    now = datetime(2026, 1, 1, 12, 0, tzinfo=UTC)
-    prompt_cache: dict[str, object] = {
-        "caching_observed": True,
-        "hit_ratio": 0.9,
-        "expires_at": now.timestamp() + expires_offset,
-        "recache_tokens_if_cold": 180_000,
-    }
-    if warm is not None:
-        prompt_cache["warm"] = warm
-
-    output = usage_statusline.render({"prompt_cache": prompt_cache}, now)
-
-    assert "90%" in output
-    assert f" ({expected})" in output
-    assert "剩" not in output
-    assert "left" not in output
-    assert f"{usage_statusline.C['dim']}{usage_statusline.C['magenta']} ({expected})" in output
-
-
-@pytest.mark.parametrize("recache_tokens", [None, 0, True, "180000"])
-def test_render_omits_recache_text_for_invalid_token_counts(
-    monkeypatch: pytest.MonkeyPatch,
-    recache_tokens: object,
-) -> None:
-    monkeypatch.setenv("USAGE_LANG", "zh-TW")
-    monkeypatch.setattr(usage_statusline, "get_width", lambda: 116)
-    now = datetime(2026, 1, 1, 12, 0, tzinfo=UTC)
-    output = usage_statusline.render(
-        {
-            "prompt_cache": {
-                "caching_observed": True,
-                "warm": False,
-                "hit_ratio": 0.9,
-                "expires_at": now.timestamp() - 1,
-                "recache_tokens_if_cold": recache_tokens,
-            }
-        },
-        now,
-    )
-
-    assert "快取:" in output
-    assert "(" not in output
-    assert "已冷" not in output
-
-
-def test_render_omits_recache_text_when_token_count_is_missing(
-    monkeypatch: pytest.MonkeyPatch,
-) -> None:
-    monkeypatch.setenv("USAGE_LANG", "zh-TW")
-    monkeypatch.setattr(usage_statusline, "get_width", lambda: 116)
-    now = datetime(2026, 1, 1, 12, 0, tzinfo=UTC)
-    output = usage_statusline.render(
-        {"prompt_cache": {"caching_observed": True, "warm": False, "hit_ratio": 0.9}},
-        now,
-    )
-
-    assert "快取:" in output
-    assert "(" not in output
-
-
 @pytest.mark.parametrize(
     "prompt_cache",
     (None, {"caching_observed": False, "hit_ratio": 0.91}),
@@ -893,12 +811,12 @@ def test_render_prompt_cache_degrades_for_narrow_widths(
     }
 
     monkeypatch.setattr(usage_statusline, "get_width", lambda: 29)
-    bar_only = usage_statusline.render(payload, now)
-    assert "Session:" not in bar_only
-    assert "Cache:" in bar_only
-    assert "43min" not in bar_only
+    pct_only = usage_statusline.render(payload, now)
+    assert "Session:" not in pct_only
+    assert "Cache:" in pct_only
+    assert "43min" not in pct_only
 
-    monkeypatch.setattr(usage_statusline, "get_width", lambda: 18)
+    monkeypatch.setattr(usage_statusline, "get_width", lambda: 17)
     without_cache = usage_statusline.render(payload, now)
     assert "Session:" not in without_cache
     assert "Cache:" not in without_cache

{usage_cli-0.31.4 → usage_cli-0.31.6}/tests/test_usage_statusline_grok.py

@@ -7,6 +7,7 @@
 from __future__ import annotations
 
 import json
+import os
 import re
 import tomllib
 from pathlib import Path
@@ -71,6 +72,11 @@ def _visible(value: str) -> str:
     return _ANSI.sub("", value)
 
 
+def test_progress_bar_chars_are_platform_specific() -> None:
+    assert usage_statusline_grok._progress_bar_chars("nt") == ("█", "░")
+    assert usage_statusline_grok._progress_bar_chars("posix") == ("■", "□")
+
+
 def test_render_fixture_contains_expected_status(
     monkeypatch: pytest.MonkeyPatch,
     tmp_path: Path,
@@ -82,11 +88,12 @@ def test_render_fixture_contains_expected_status(
     monkeypatch.setenv("COLUMNS", "300")
 
     output = _visible(usage_statusline_grok.render(_fixture_data()))
+    filled, empty = usage_statusline_grok._progress_bar_chars(os.name)
 
     assert "project(main)" in output
-    assert "週配額:■■■□□□□□ 42%" in output
+    assert f"週配額:{filled * 3}{empty * 5} 42%" in output
     assert re.search(r"\(剩[0-9]+d[0-9]+h\)", output)
-    assert "對話窗:■□□□□□□□ 8% / 2.0M" in output
+    assert f"對話窗:{filled}{empty * 7} 8% / 2.0M" in output
     assert "會話時長:20min" in output
     assert "Grok 4.6/深思" in output
     assert output.count("\n") == 1
@@ -160,7 +167,8 @@ def test_render_degrades_for_narrow_terminal(
     assert "Weekly:42%" in first_line
     assert "Context:8%" in first_line
     assert "left" not in first_line
-    assert "■" not in first_line
+    filled, _empty = usage_statusline_grok._progress_bar_chars(os.name)
+    assert filled not in first_line
 
 
 def _patch_grok_paths(monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> tuple[Path, Path, Path]:
@@ -377,5 +385,6 @@ def test_render_shows_zero_quota_when_percent_is_omitted(
     monkeypatch.setenv("COLUMNS", "300")
 
     output = _visible(usage_statusline_grok.render(_fixture_data()))
+    _filled, empty = usage_statusline_grok._progress_bar_chars(os.name)
 
-    assert "週配額:□□□□□□□□ 0%" in output
+    assert f"週配額:{empty * 8} 0%" in output