usage-cli 0.34.5__tar.gz → 0.34.7__tar.gz

{usage_cli-0.34.5/usage_cli.egg-info → usage_cli-0.34.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.34.5
+Version: 0.34.7
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -28,7 +28,7 @@ Dynamic: license-file
 
 ### Your Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quota, always on screen.
 
-`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.
+`usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, and turns a quota red as it nears its limit. 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/)
 
@@ -48,7 +48,7 @@ Dynamic: license-file
 </p>
 
 - **Every quota at a glance:** Claude Code, Codex, Antigravity, and Muse Code session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
-- **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
+- **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from its own CLI (no model call), or from Google's official endpoint using the sign-in that CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
 - **Warns before tokens go to waste:** The Claude Code status line flags a bloating context window and a cold prompt cache. A banner shows Claude or Codex outages.
 - **Helpers inside Claude Code:** A side pane, shorter replies, a progress hand-off for new sessions, and quota-aware planning. All optional.
 - **Reports and 16 themes:** HTML reports of token trends and cost, and 16 panel themes to pick from.
@@ -95,7 +95,7 @@ Then click the menu bar or tray icon.
 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.
 Restart the relevant tool afterward (on macOS, fully Cmd+Q Claude Code and re-open it; on Windows, restart your terminal or start a new session).
 
-The same button also sets up a status line for the Antigravity CLI and for Grok CLI when they are installed on your machine, and does nothing at all when they aren't. Any status line you configured there yourself is backed up first and restored when you turn the switch off.
+The same button also sets up a status line for the Antigravity CLI and for Grok CLI when they are installed on your machine, and does nothing at all when they aren't. Any status line you configured there yourself is backed up first and restored when you turn the switch off. The switch is **⚙ Settings → Claude Code → Sync quota via status line**; with it off, the Claude quota stops updating.
 
 Once set up, the bottom of the Claude Code window will show a status line like this:
 
@@ -107,8 +107,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 ### On Screen
 
-- **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
-- **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to switch to the separate Claude / GPT pool; the choice is remembered.
+- **Menu bar monitor:** A quota turns red as it nears its limit. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
+- **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to cycle through the separate Claude / GPT and Gemini 4 Argon pools; the choice is remembered. Argon has a weekly limit only.
 - **Grok CLI card:** The weekly credit percentage from Grok CLI's local debug log. Its tokens also count toward cost and project totals.
 - **Muse Code card:** Shows 5-hour (Session) and weekly quota with reset countdowns. Available in all 15 quota themes, with a menu bar item and optional low, exhausted, and recovered quota notifications. Hidden automatically when Muse is not installed. Tokens and cost still count toward today's cost, project totals, reports, and the CLI.
 - **Outage alerts:** An orange-red banner when Claude Code, Claude API, or Codex API is down or degraded, read from their public status pages.
@@ -129,10 +129,10 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 ### Reports and More
 
-- **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking.
+- **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking. If you hand work from Claude Code to Codex or Antigravity, the report shows which conversations used how much of each weekly quota.
 - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, Grok, and Muse quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
-- **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of Claude Code, Codex, and Antigravity changes, with plain-language summaries in five languages.
-- **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
+- **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of changes to Claude Code, Codex, Antigravity, Grok Build, Muse Code, GitHub CLI, and usage itself, with plain-language summaries in five languages.
+- **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes from **⚙ Settings → Switch Panel**. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
 
 <details>
 <summary>Thresholds, versions, and fine print</summary>
@@ -147,7 +147,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 - **Progress Concierge:** When you `/resume` a conversation that sat long enough for its cache to expire, it warns how many tokens the next message will re-send and suggests `/compact` first.
 - **Beginner Mode (macOS and Windows):** Terms appear above the prompt in your UI language. Press 9 to mark them understood; skipped terms come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day, and a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, and pauses while your 5-hour quota is at 90% or more.
 - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, Antigravity, and Muse, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
-- **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible.
+- **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible. The Claude and Codex pings skip your own hooks and stay out of `claude --resume` and `codex resume`.
 - **Panel:** It stays put when another app takes focus; a second click on the menu bar icon, or Escape, closes it. Card order is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **HTML reports:** A "What you worked on" section lists the names Claude Code gave your recent conversations, and masking covers those titles too.
 - **AI Update Daily:** Unreviewed items show the original source text. The full history is kept.
@@ -218,19 +218,18 @@ Switch between **16 visual themes** directly from the UI:
 
 ## Comparison
 
+As of October 2026. ccusage and TokenTracker read many more AI tools; `usage` focuses on five and their quotas.
+
 | Feature | usage | ccusage | TokenTracker |
 |---------|:-----:|:-------:|:------------:|
-| Always on screen | ✅ | — | ✅ |
-| macOS menu bar & Windows system tray | ✅ | — | macOS only |
-| Claude Code & Codex usage | ✅ | ✅ | ✅ |
-| Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
-| Grok CLI usage | ✅ | — | — |
-| Muse Code quota, tokens, and cost | ✅ | — | — |
-| Claude Code & Codex service-status alerts | ✅ | — | — |
-| HTML deep reports & UI | ✅ | ✅ | — |
-| Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, health check) | ✅ | — | — |
+| Menu bar or system tray app | macOS, Windows | — | macOS, Windows, Linux |
+| Token and cost reports | ✅ | ✅ | ✅ |
+| Live 5-hour and weekly quota | ✅ | Estimated Claude 5-hour blocks only | ✅ |
+| Muse Code quota | ✅ | — | — |
+| Service status from official status pages | Claude, Codex | — | 8 providers |
+| Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, side pane, health check) | ✅ | — | — |
 | AI Update Daily | ✅ | — | — |
-| Open-source license | AGPL-3.0 | MIT | — |
+| Open-source license | AGPL-3.0 | MIT | MIT |
 
 ## When usage Isn't the Right Fit
 
@@ -271,7 +270,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 
 - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code token and cost numbers are read from log files on your machine. Their contents are never uploaded.
 - **Claude Desktop:** Without the Claude Code CLI or a status line, keep Claude Desktop open and `usage` reads its local plan-usage history. No cookies, login tokens, or API calls are needed. Reset times appear only when its local cache confirms them; they are never estimated.
-- **Antigravity**, only if you use it, needs network access: quota is fetched from Google's official quota endpoint with 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` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
+- **Antigravity**, only if you use it, needs network access: quota comes first from `agy -p /usage`, which makes no model call; if that fails, it is fetched from Google's official quota endpoint with 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` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - **Muse quota:** Muse stores no quota file locally. `usage` runs `muse exec --json` through Muse's own sign-in and saves the returned quota to `~/.usage/muse_quota.json`. This connects to Muse and makes a real model call, using a little Muse quota. It runs in an empty folder with `--no-session-log`. With Muse installed and a conversation available, it fetches the first snapshot; later probes require a snapshot over 30 minutes old and a newer Muse conversation. After failure, it waits at least 30 minutes and requires new Muse usage before retrying. Hide its card under **Hide sections**.
 - **Other background network activity:** Public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (built-in prices are used offline), and an occasional GitHub check for a new version.
 - **Beginner Mode**, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.

{usage_cli-0.34.5 → usage_cli-0.34.7}/README.md

@@ -6,7 +6,7 @@
 
 ### Your Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quota, always on screen.
 
-`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.
+`usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, and turns a quota red as it nears its limit. 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/)
 
@@ -26,7 +26,7 @@
 </p>
 
 - **Every quota at a glance:** Claude Code, Codex, Antigravity, and Muse Code session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
-- **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
+- **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from its own CLI (no model call), or from Google's official endpoint using the sign-in that CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
 - **Warns before tokens go to waste:** The Claude Code status line flags a bloating context window and a cold prompt cache. A banner shows Claude or Codex outages.
 - **Helpers inside Claude Code:** A side pane, shorter replies, a progress hand-off for new sessions, and quota-aware planning. All optional.
 - **Reports and 16 themes:** HTML reports of token trends and cost, and 16 panel themes to pick from.
@@ -73,7 +73,7 @@ Then click the menu bar or tray icon.
 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.
 Restart the relevant tool afterward (on macOS, fully Cmd+Q Claude Code and re-open it; on Windows, restart your terminal or start a new session).
 
-The same button also sets up a status line for the Antigravity CLI and for Grok CLI when they are installed on your machine, and does nothing at all when they aren't. Any status line you configured there yourself is backed up first and restored when you turn the switch off.
+The same button also sets up a status line for the Antigravity CLI and for Grok CLI when they are installed on your machine, and does nothing at all when they aren't. Any status line you configured there yourself is backed up first and restored when you turn the switch off. The switch is **⚙ Settings → Claude Code → Sync quota via status line**; with it off, the Claude quota stops updating.
 
 Once set up, the bottom of the Claude Code window will show a status line like this:
 
@@ -85,8 +85,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 ### On Screen
 
-- **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
-- **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to switch to the separate Claude / GPT pool; the choice is remembered.
+- **Menu bar monitor:** A quota turns red as it nears its limit. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
+- **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to cycle through the separate Claude / GPT and Gemini 4 Argon pools; the choice is remembered. Argon has a weekly limit only.
 - **Grok CLI card:** The weekly credit percentage from Grok CLI's local debug log. Its tokens also count toward cost and project totals.
 - **Muse Code card:** Shows 5-hour (Session) and weekly quota with reset countdowns. Available in all 15 quota themes, with a menu bar item and optional low, exhausted, and recovered quota notifications. Hidden automatically when Muse is not installed. Tokens and cost still count toward today's cost, project totals, reports, and the CLI.
 - **Outage alerts:** An orange-red banner when Claude Code, Claude API, or Codex API is down or degraded, read from their public status pages.
@@ -107,10 +107,10 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 
 ### Reports and More
 
-- **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking.
+- **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking. If you hand work from Claude Code to Codex or Antigravity, the report shows which conversations used how much of each weekly quota.
 - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, Grok, and Muse quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
-- **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of Claude Code, Codex, and Antigravity changes, with plain-language summaries in five languages.
-- **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
+- **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of changes to Claude Code, Codex, Antigravity, Grok Build, Muse Code, GitHub CLI, and usage itself, with plain-language summaries in five languages.
+- **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes from **⚙ Settings → Switch Panel**. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
 
 <details>
 <summary>Thresholds, versions, and fine print</summary>
@@ -125,7 +125,7 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 - **Progress Concierge:** When you `/resume` a conversation that sat long enough for its cache to expire, it warns how many tokens the next message will re-send and suggests `/compact` first.
 - **Beginner Mode (macOS and Windows):** Terms appear above the prompt in your UI language. Press 9 to mark them understood; skipped terms come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day, and a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, and pauses while your 5-hour quota is at 90% or more.
 - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, Antigravity, and Muse, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
-- **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible.
+- **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible. The Claude and Codex pings skip your own hooks and stay out of `claude --resume` and `codex resume`.
 - **Panel:** It stays put when another app takes focus; a second click on the menu bar icon, or Escape, closes it. Card order is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
 - **HTML reports:** A "What you worked on" section lists the names Claude Code gave your recent conversations, and masking covers those titles too.
 - **AI Update Daily:** Unreviewed items show the original source text. The full history is kept.
@@ -196,19 +196,18 @@ Switch between **16 visual themes** directly from the UI:
 
 ## Comparison
 
+As of October 2026. ccusage and TokenTracker read many more AI tools; `usage` focuses on five and their quotas.
+
 | Feature | usage | ccusage | TokenTracker |
 |---------|:-----:|:-------:|:------------:|
-| Always on screen | ✅ | — | ✅ |
-| macOS menu bar & Windows system tray | ✅ | — | macOS only |
-| Claude Code & Codex usage | ✅ | ✅ | ✅ |
-| Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
-| Grok CLI usage | ✅ | — | — |
-| Muse Code quota, tokens, and cost | ✅ | — | — |
-| Claude Code & Codex service-status alerts | ✅ | — | — |
-| HTML deep reports & UI | ✅ | ✅ | — |
-| Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, health check) | ✅ | — | — |
+| Menu bar or system tray app | macOS, Windows | — | macOS, Windows, Linux |
+| Token and cost reports | ✅ | ✅ | ✅ |
+| Live 5-hour and weekly quota | ✅ | Estimated Claude 5-hour blocks only | ✅ |
+| Muse Code quota | ✅ | — | — |
+| Service status from official status pages | Claude, Codex | — | 8 providers |
+| Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, side pane, health check) | ✅ | — | — |
 | AI Update Daily | ✅ | — | — |
-| Open-source license | AGPL-3.0 | MIT | — |
+| Open-source license | AGPL-3.0 | MIT | MIT |
 
 ## When usage Isn't the Right Fit
 
@@ -249,7 +248,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 
 - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code token and cost numbers are read from log files on your machine. Their contents are never uploaded.
 - **Claude Desktop:** Without the Claude Code CLI or a status line, keep Claude Desktop open and `usage` reads its local plan-usage history. No cookies, login tokens, or API calls are needed. Reset times appear only when its local cache confirms them; they are never estimated.
-- **Antigravity**, only if you use it, needs network access: quota is fetched from Google's official quota endpoint with 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` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
+- **Antigravity**, only if you use it, needs network access: quota comes first from `agy -p /usage`, which makes no model call; if that fails, it is fetched from Google's official quota endpoint with 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` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - **Muse quota:** Muse stores no quota file locally. `usage` runs `muse exec --json` through Muse's own sign-in and saves the returned quota to `~/.usage/muse_quota.json`. This connects to Muse and makes a real model call, using a little Muse quota. It runs in an empty folder with `--no-session-log`. With Muse installed and a conversation available, it fetches the first snapshot; later probes require a snapshot over 30 minutes old and a newer Muse conversation. After failure, it waits at least 30 minutes and requires new Muse usage before retrying. Hide its card under **Hide sections**.
 - **Other background network activity:** Public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (built-in prices are used offline), and an occasional GitHub check for a new version.
 - **Beginner Mode**, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.

{usage_cli-0.34.5 → usage_cli-0.34.7}/analyzer/dispatch_ledger.py

@@ -18,6 +18,7 @@ from adapters import rate_limits
 from adapters.types import UsageEntry
 from loaders import agy_loader, agy_quota_probe, codex_loader, muse_quota_probe
 from loaders.claude_paths import claude_config_dirs
+from usage_common.project_resolver import resolve_project_name
 
 _DISPATCH = {
     "codex": re.compile(r"(^|[;&|(\s])codex exec"),
@@ -61,7 +62,10 @@ class LedgerRow(TypedDict):
     dispatch_count: int
     claude_pct: float | None
     codex_pct: float | None
-    agy_pct: float | None
+    agy_groups: dict[str, float]
+    claude_reset: bool
+    codex_reset: bool
+    agy_reset: bool
     total_pct: float
 
 
@@ -69,6 +73,52 @@ class LedgerData(TypedDict):
     rows: list[LedgerRow]
     unowned_codex: int
     unowned_agy: int
+    used_pct: dict[str, float]
+
+
+class LedgerBlock(TypedDict):
+    quota: str
+    used_pct: float | None
+    conversations: list[tuple[LedgerRow, float]]
+    more_count: int
+    more_pct: float
+    other_pct: float | None
+    all_reset: bool
+
+
+def ledger_blocks(rows: list[LedgerRow], used_pct: dict[str, float]) -> list[LedgerBlock]:
+    """Select each quota's top five from every owned conversation."""
+    shares: dict[str, list[tuple[LedgerRow, float]]] = defaultdict(list)
+    for row in rows:
+        if row["codex_pct"] is not None and row["codex_pct"] > 0:
+            shares["codex"].append((row, row["codex_pct"]))
+        for group, value in row["agy_groups"].items():
+            if value > 0:
+                shares[f"antigravity:{group}"].append((row, value))
+    if any(row["codex_reset"] for row in rows):
+        shares.setdefault("codex", [])
+    blocks: list[LedgerBlock] = []
+    for quota, conversations in shares.items():
+        conversations.sort(key=lambda item: item[1], reverse=True)
+        total = sum(value for _, value in conversations)
+        used = used_pct.get(quota)
+        other = max(0.0, used - total) if used is not None else None
+        blocks.append(
+            {
+                "quota": quota,
+                "used_pct": used,
+                "conversations": conversations[:5],
+                "more_count": len(conversations[5:]),
+                "more_pct": sum(value for _, value in conversations[5:]),
+                "other_pct": other if other is not None and other >= 0.5 else None,
+                "all_reset": quota == "codex" and not conversations,
+            }
+        )
+    blocks.sort(
+        key=lambda block: sum(value for _, value in block["conversations"]) + block["more_pct"],
+        reverse=True,
+    )
+    return blocks
 
 
 def _timestamp(value: object) -> datetime | None:
@@ -319,11 +369,15 @@ def estimate_pct(
     return session_tokens / total_tokens * window.used_pct
 
 
+SessionGroup = tuple[str, str, str]
+
+
 def estimate_sessions(
     entries: list[UsageEntry], windows: dict[str, QuotaWindow], now: datetime
-) -> dict[tuple[str, str], float | None]:
+) -> tuple[dict[SessionGroup, float], set[SessionGroup]]:
     totals: dict[str, int] = defaultdict(int)
     sessions: dict[tuple[str, str, str], int] = defaultdict(int)
+    before_window: set[SessionGroup] = set()
     for entry in entries:
         group = entry.agent_id
         if entry.agent_id == "antigravity":
@@ -351,18 +405,21 @@ def estimate_sessions(
                 "",
             )
         window = windows.get(group)
-        if window is None or not window.resets_at - window.length <= entry.timestamp <= now:
-            continue
         tokens = entry.input_tokens + entry.output_tokens + entry.cache_creation_tokens
+        if window is None or entry.timestamp > now or tokens <= 0:
+            continue
+        key = (entry.agent_id, entry.session_id, group)
+        if entry.timestamp < window.resets_at - window.length:
+            before_window.add(key)
+            continue
         totals[group] += tokens
-        sessions[(entry.agent_id, entry.session_id, group)] += tokens
-    estimates: dict[tuple[str, str], float | None] = {}
+        sessions[key] += tokens
+    estimates: dict[SessionGroup, float] = {}
     for (agent_id, session_id, group), tokens in sessions.items():
         value = estimate_pct(tokens, totals[group], windows.get(group), now)
         if value is not None:
-            key = (agent_id, session_id)
-            estimates[key] = (estimates.get(key) or 0.0) + value
-    return estimates
+            estimates[(agent_id, session_id, group)] = value
+    return estimates, before_window - sessions.keys()
 
 
 def _session_title(path: Path) -> str:
@@ -392,13 +449,23 @@ def _session_title(path: Path) -> str:
     return title or first_text
 
 
-def build_ledger(estimates: dict[tuple[str, str], float | None], now: datetime) -> LedgerData:
+def build_ledger(
+    estimates: dict[SessionGroup, float],
+    now: datetime,
+    reset_sessions: set[SessionGroup] | None = None,
+    used_pct: dict[str, float] | None = None,
+) -> LedgerData:
     cutoff = now - timedelta(days=7)
     paths = _claude_paths(cutoff)
     dispatches = [
         item for path in paths for item in _read_dispatches(path) if cutoff <= item.timestamp <= now
     ]
-    empty: LedgerData = {"rows": [], "unowned_codex": 0, "unowned_agy": 0}
+    empty: LedgerData = {
+        "rows": [],
+        "unowned_codex": 0,
+        "unowned_agy": 0,
+        "used_pct": used_pct or {},
+    }
     if not dispatches:
         return empty
     known_sessions = {path.stem for path in paths}
@@ -426,32 +493,51 @@ def build_ledger(estimates: dict[tuple[str, str], float | None], now: datetime)
         origin = by_owner.get(owner)
         if not origin:
             continue
-        shares = {"claude-code": estimates.get(("claude-code", owner))}
-        for agent_id in ("codex", "antigravity"):
-            values = [estimates.get((agent_id, session_id)) for session_id in children[agent_id]]
-            shares[agent_id] = (
-                sum(value for value in values if value is not None)
-                if any(value is not None for value in values)
-                else None
-            )
+        claude_pct = estimates.get(("claude-code", owner, "claude-code"))
+        codex_values = [
+            estimates[("codex", child, "codex")]
+            for child in children["codex"]
+            if ("codex", child, "codex") in estimates
+        ]
+        codex_pct = sum(codex_values) if codex_values else None
+        agy_groups: dict[str, float] = {}
+        for (agent, child, group), value in estimates.items():
+            if agent == "antigravity" and child in children[agent]:
+                name = group.removeprefix("antigravity:")
+                agy_groups[name] = agy_groups.get(name, 0.0) + value
+        reset_agents = {
+            agent
+            for agent, session, _ in reset_sessions or set()
+            if (agent == "claude-code" and session == owner)
+            or session in children.get(agent, set())
+        }
         first = min(origin, key=lambda item: item.timestamp)
         rows.append(
             (
                 owner,
                 {
                     "date": first.timestamp.astimezone().strftime("%Y-%m-%d"),
-                    "project": Path(first.cwd).name or "unknown",
+                    "project": resolve_project_name(first.cwd),
                     "title": "",
                     "dispatch_count": len(origin),
-                    "claude_pct": shares["claude-code"],
-                    "codex_pct": shares["codex"],
-                    "agy_pct": shares["antigravity"],
-                    "total_pct": sum(value for value in shares.values() if value is not None),
+                    "claude_pct": claude_pct,
+                    "codex_pct": codex_pct,
+                    "agy_groups": agy_groups,
+                    "claude_reset": claude_pct is None and "claude-code" in reset_agents,
+                    "codex_reset": codex_pct is None and "codex" in reset_agents,
+                    "agy_reset": not agy_groups and "antigravity" in reset_agents,
+                    "total_pct": (claude_pct or 0) + (codex_pct or 0) + sum(agy_groups.values()),
                 },
             )
         )
     rows.sort(key=lambda item: item[1]["total_pct"], reverse=True)
-    for owner, row in rows[:15]:
-        row["title"] = _session_title(path_by_session[owner])
-        empty["rows"].append(row)
+    empty["rows"] = [row for _, row in rows]
+    displayed = {
+        id(row)
+        for block in ledger_blocks(empty["rows"], empty["used_pct"])
+        for row, _ in block["conversations"]
+    }
+    for owner, row in rows:
+        if id(row) in displayed:
+            row["title"] = _session_title(path_by_session[owner])
     return empty

{usage_cli-0.34.5 → usage_cli-0.34.7}/analyzer/reporter.py

@@ -16,6 +16,7 @@ import logging
 import os
 from pathlib import Path
 import tempfile
+import threading
 import time
 from typing import Any, NotRequired, TypedDict, cast
 
@@ -45,6 +46,7 @@ YEAR_LEDGER_PATH = YEAR_CACHE_PATH.with_name("year_ledger.json")
 YEAR_CACHE_TTL_SECONDS = 6 * 3600
 _YEAR_CACHE_SCHEMA = 6
 _YEAR_LEDGER_SCHEMA = 1
+_year_ledger_lock = threading.Lock()
 _YEAR_LEDGER_TRIM_BUFFER_DAYS = 60
 
 
@@ -675,18 +677,21 @@ def _merge_year_ledger(
     *,
     trim_before: date,
 ) -> _YearLedger:
-    ledger = _read_year_ledger()
-    days = ledger["days"]
-    for day_key, current_day in current_days.items():
-        ledger_day = days.get(day_key)
-        if ledger_day is None or current_day["total_tokens"] >= ledger_day["total_tokens"]:
-            days[day_key] = current_day
-
-    ledger["days"] = {
-        day_key: day for day_key, day in days.items() if date.fromisoformat(day_key) >= trim_before
-    }
-    _write_year_ledger(ledger)
-    return ledger
+    with _year_ledger_lock:
+        ledger = _read_year_ledger()
+        days = ledger["days"]
+        for day_key, current_day in current_days.items():
+            ledger_day = days.get(day_key)
+            if ledger_day is None or current_day["total_tokens"] >= ledger_day["total_tokens"]:
+                days[day_key] = current_day
+
+        ledger["days"] = {
+            day_key: day
+            for day_key, day in days.items()
+            if date.fromisoformat(day_key) >= trim_before
+        }
+        _write_year_ledger(ledger)
+        return ledger
 
 
 def _build_year_output_from_ledger(
@@ -1258,7 +1263,13 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         entry for entry in weekly_entries if not ledger_backfill.is_ledger_entry(entry)
     ]
     windows = dispatch_ledger.load_windows() if weekly_entries else {}
-    estimates = dispatch_ledger.estimate_sessions(weekly_entries, windows, now)
+    group_estimates, reset_sessions = dispatch_ledger.estimate_sessions(
+        weekly_entries, windows, now
+    )
+    estimates: dict[tuple[str, str], float] = {}
+    for (agent_id, session_id, _), value in group_estimates.items():
+        key = (agent_id, session_id)
+        estimates[key] = estimates.get(key, 0.0) + value
     sessions_by_cost = sorted(
         aggregate_sessions(real_entries), key=lambda session: session.cost_usd, reverse=True
     )
@@ -1322,7 +1333,12 @@ def build_report_data(agents: list[AgentInfo], period: str = "month") -> ReportD
         "sessions": session_rows,
         "daily_trend": daily_trend,
         "top_sessions": top_sessions,
-        "dispatch_ledger": dispatch_ledger.build_ledger(estimates, now),
+        "dispatch_ledger": dispatch_ledger.build_ledger(
+            group_estimates,
+            now,
+            reset_sessions,
+            {key: window.used_pct for key, window in windows.items()},
+        ),
         "comparison": comparison,
         "subscriptions": subscription.load_subscriptions(),
         "persona": _load_persona_for_period(period),

{usage_cli-0.34.5 → usage_cli-0.34.7}/analyzer/usage_snapshot.py

@@ -23,6 +23,7 @@ import logging
 import os
 from pathlib import Path
 import tempfile
+import threading
 from typing import NotRequired, TypeGuard, TypedDict
 
 from adapters.types import UsageEntry
@@ -33,6 +34,7 @@ logger = logging.getLogger(__name__)
 
 SNAPSHOT_PATH = Path(os.path.expanduser("~/.usage/usage_snapshot.json"))
 SNAPSHOT_SCHEMA = 1
+_snapshot_lock = threading.Lock()
 
 _RowKey = tuple[str, str, str, str, str]
 
@@ -79,9 +81,10 @@ def record_entries(
 ) -> UsageSnapshot:
     """Merge this load into the on-disk snapshot and return the result."""
     new_rows, new_headers = _aggregate_entries(entries, entry_dates)
-    merged = _merge_snapshot(_read_snapshot(), new_rows, new_headers)
-    _write_snapshot(merged)
-    return merged
+    with _snapshot_lock:
+        merged = _merge_snapshot(_read_snapshot(), new_rows, new_headers)
+        _write_snapshot(merged)
+        return merged
 
 
 def read_snapshot() -> UsageSnapshot: