usage-cli 0.33.9__tar.gz → 0.34.0__tar.gz

{usage_cli-0.33.9/usage_cli.egg-info → usage_cli-0.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.33.9
+Version: 0.34.0
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -26,7 +26,7 @@ Dynamic: license-file
 
 # usage
 
-### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
+### 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.
 
@@ -47,8 +47,8 @@ Dynamic: license-file
   <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
 </p>
 
-- **Every quota at a glance:** Claude Code, Codex, and Antigravity session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
-- **Reads what's already on your machine:** Claude Code, Codex, and Grok CLI numbers come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores.
+- **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.
 - **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.
@@ -88,7 +88,7 @@ Then click the menu bar or tray icon.
 
 </details>
 
-`usage` needs data from at least one of Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app.
+`usage` needs data from at least one of Claude Code, Codex, Antigravity, Grok CLI, or Muse Code, or a running Claude Desktop app.
 
 ## First Launch: Set Up the Status Line
 
@@ -107,13 +107,13 @@ 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.
+- **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.
 - **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 spending:** Its tokens and cost count toward today's cost, project totals, reports, and the CLI. Muse keeps no quota data locally, so it has no card.
+- **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.
 - **Context and cache warnings:** The status line nudges you to `/clear` or `/compact` before the context window bloats, and says why the prompt cache missed.
-- **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels in one click.
+- **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, Antigravity, or Muse Code section from the menu bar and panels in one click.
 
 ### Inside Claude Code
 
@@ -130,9 +130,9 @@ 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.
-- **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
+- **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.
+- **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.
 
 <details>
 <summary>Thresholds, versions, and fine print</summary>
@@ -146,8 +146,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 - **Linux:** CI verifies `usage setup` on Ubuntu.
 - **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, and Antigravity, 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. Checking your quota never sends a message; only this switch does.
+- **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.
 - **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.
@@ -225,7 +225,7 @@ Switch between **16 visual themes** directly from the UI:
 | Claude Code & Codex usage | ✅ | ✅ | ✅ |
 | Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
 | Grok CLI usage | ✅ | — | — |
-| Muse Code token spend | ✅ | — | — |
+| 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) | ✅ | — | — |
@@ -235,7 +235,7 @@ Switch between **16 visual themes** directly from the UI:
 ## 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, Antigravity, Grok CLI, or Claude Desktop — there's no usage data for `usage` to read.
+- You don't use Claude Code, Codex, Antigravity, Grok CLI, Muse Code, or Claude Desktop — there's no 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.
 
 ## Windows Support
@@ -269,9 +269,10 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 
 ## Privacy & Data Sources
 
-- **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code numbers are read from log files on your machine. Their contents are never uploaded.
+- **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.
+- **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`.
 - **Long-term history:** Claude Code deletes transcripts older than 30 days by default. While the app runs, `usage` saves daily totals to `~/.usage/usage_snapshot.json` and `~/.usage/year_ledger.json` every 6 hours, so reports keep older days. Nothing leaves your machine. When you move to a new computer, copy the whole `~/.usage/` folder too.

{usage_cli-0.33.9 → usage_cli-0.34.0}/README.md

@@ -4,7 +4,7 @@
 
 # usage
 
-### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
+### 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.
 
@@ -25,8 +25,8 @@
   <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
 </p>
 
-- **Every quota at a glance:** Claude Code, Codex, and Antigravity session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
-- **Reads what's already on your machine:** Claude Code, Codex, and Grok CLI numbers come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores.
+- **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.
 - **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.
@@ -66,7 +66,7 @@ Then click the menu bar or tray icon.
 
 </details>
 
-`usage` needs data from at least one of Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app.
+`usage` needs data from at least one of Claude Code, Codex, Antigravity, Grok CLI, or Muse Code, or a running Claude Desktop app.
 
 ## First Launch: Set Up the Status Line
 
@@ -85,13 +85,13 @@ 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.
+- **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.
 - **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 spending:** Its tokens and cost count toward today's cost, project totals, reports, and the CLI. Muse keeps no quota data locally, so it has no card.
+- **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.
 - **Context and cache warnings:** The status line nudges you to `/clear` or `/compact` before the context window bloats, and says why the prompt cache missed.
-- **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels in one click.
+- **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, Antigravity, or Muse Code section from the menu bar and panels in one click.
 
 ### Inside Claude Code
 
@@ -108,9 +108,9 @@ 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.
-- **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
+- **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.
+- **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.
 
 <details>
 <summary>Thresholds, versions, and fine print</summary>
@@ -124,8 +124,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
 - **Linux:** CI verifies `usage setup` on Ubuntu.
 - **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, and Antigravity, 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. Checking your quota never sends a message; only this switch does.
+- **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.
 - **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.
@@ -203,7 +203,7 @@ Switch between **16 visual themes** directly from the UI:
 | Claude Code & Codex usage | ✅ | ✅ | ✅ |
 | Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
 | Grok CLI usage | ✅ | — | — |
-| Muse Code token spend | ✅ | — | — |
+| 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) | ✅ | — | — |
@@ -213,7 +213,7 @@ Switch between **16 visual themes** directly from the UI:
 ## 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, Antigravity, Grok CLI, or Claude Desktop — there's no usage data for `usage` to read.
+- You don't use Claude Code, Codex, Antigravity, Grok CLI, Muse Code, or Claude Desktop — there's no 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.
 
 ## Windows Support
@@ -247,9 +247,10 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 
 ## Privacy & Data Sources
 
-- **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code numbers are read from log files on your machine. Their contents are never uploaded.
+- **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.
+- **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`.
 - **Long-term history:** Claude Code deletes transcripts older than 30 days by default. While the app runs, `usage` saves daily totals to `~/.usage/usage_snapshot.json` and `~/.usage/year_ledger.json` every 6 hours, so reports keep older days. Nothing leaves your machine. When you move to a new computer, copy the whole `~/.usage/` folder too.

{usage_cli-0.33.9 → usage_cli-0.34.0}/analyzer/dispatch_ledger.py

@@ -16,7 +16,7 @@ from typing import Any, TypedDict
 
 from adapters import rate_limits
 from adapters.types import UsageEntry
-from loaders import agy_loader, agy_quota_probe, codex_loader
+from loaders import agy_loader, agy_quota_probe, codex_loader, muse_quota_probe
 from loaders.claude_paths import claude_config_dirs
 
 _DISPATCH = {
@@ -303,6 +303,11 @@ def load_windows() -> dict[str, QuotaWindow]:
                 windows[group_key] = window
                 for model in group.models:
                     windows[f"antigravity-model:{model.lower()}"] = window
+    muse = muse_quota_probe.read_cache()
+    if muse:
+        window = _window(muse["weekly"]["used_percent"], muse["weekly"]["resets_at"], 7 * 24 * 60)
+        if window:
+            windows["muse"] = window
     return windows
 
 

{usage_cli-0.33.9 → usage_cli-0.34.0}/i18n.json

@@ -109,6 +109,7 @@
     "agy_stale_tooltip": "顯示的是快取舊值。額度直接向官方 API 取得，通常每幾分鐘自動更新；出現舊值代表最近取用失敗（多半是 agy 尚未登入，或網路問題），成功後會自動恢復。",
     "grok_name": "Grok",
     "muse_name": "Muse",
+    "muse_stale_tooltip": "資料來自上次 Muse 額度探測，可能已過期；Muse 有新用量後會自動重試。",
     "grok_stale_minutes": "約 {minutes} 分鐘前",
     "grok_stale_hours": "約 {hours} 小時前",
     "grok_stale_tooltip": "資料來自 Grok CLI 本機 log，不是即時 API；請最近執行過 grok 指令後再查看，才會更新。",
@@ -667,6 +668,7 @@
     "agy_stale_tooltip": "Showing a cached value. Quota is fetched straight from the official API, usually updating every few minutes; an old value means the last fetch failed (often agy isn't signed in, or there's a network issue), and it recovers automatically once a fetch succeeds.",
     "grok_name": "Grok",
     "muse_name": "Muse",
+    "muse_stale_tooltip": "Data comes from the last Muse quota probe and may be outdated. It will retry automatically after Muse has new usage.",
     "grok_stale_minutes": "about {minutes} minutes ago",
     "grok_stale_hours": "about {hours} hours ago",
     "grok_stale_tooltip": "Data comes from Grok CLI's local log, not a live API. Run a grok command recently for it to update.",
@@ -1225,6 +1227,7 @@
     "agy_stale_tooltip": "显示的是缓存旧值。额度直接从官方 API 获取，通常每隔几分钟自动更新；出现旧值说明最近获取失败（多半是 agy 尚未登录，或网络问题），成功后会自动恢复。",
     "grok_name": "Grok",
     "muse_name": "Muse",
+    "muse_stale_tooltip": "资料来自上次 Muse 额度探测，可能已过期；Muse 有新用量后会自动重试。",
     "grok_stale_minutes": "约 {minutes} 分钟前",
     "grok_stale_hours": "约 {hours} 小时前",
     "grok_stale_tooltip": "资料来自 Grok CLI 本地日志，不是即时 API；请最近运行过 grok 指令后再查看，才会更新。",
@@ -1783,6 +1786,7 @@
     "agy_stale_tooltip": "キャッシュされた値を表示しています。利用枠は公式 API から直接取得し、通常数分ごとに自動更新されます。古い値が表示されるのは直近の取得に失敗したためです（多くの場合 agy が未サインイン、またはネットワークの問題）。取得に成功すると自動的に復旧します。",
     "grok_name": "Grok",
     "muse_name": "Muse",
+    "muse_stale_tooltip": "前回の Muse 利用枠確認のデータです。古い可能性があります。Muse に新しい利用があると自動で再試行します。",
     "grok_stale_minutes": "約 {minutes} 分前",
     "grok_stale_hours": "約 {hours} 時間前",
     "grok_stale_tooltip": "データは Grok CLI のローカルログから読み取るもので、リアルタイム API ではありません。更新するには最近 grok コマンドを実行してください。",
@@ -2341,6 +2345,7 @@
     "agy_stale_tooltip": "캐시된 값을 표시하고 있습니다. 사용량은 공식 API에서 직접 가져오며 보통 몇 분마다 자동 업데이트됩니다. 예전 값이 보이는 건 최근 가져오기에 실패했기 때문입니다(대개 agy 미로그인 또는 네트워크 문제). 가져오기에 성공하면 자동으로 복구됩니다.",
     "grok_name": "Grok",
     "muse_name": "Muse",
+    "muse_stale_tooltip": "마지막 Muse 할당량 확인 데이터로, 오래되었을 수 있습니다. Muse에 새 사용량이 생기면 자동으로 다시 시도합니다.",
     "grok_stale_minutes": "약 {minutes}분 전",
     "grok_stale_hours": "약 {hours}시간 전",
     "grok_stale_tooltip": "데이터는 Grok CLI의 로컬 로그에서 읽으며 실시간 API가 아닙니다. 업데이트하려면 최근에 grok 명령을 실행하세요.",

{usage_cli-0.33.9 → usage_cli-0.34.0}/installer/session_hooks.py

@@ -94,7 +94,7 @@ _TERSE_REMINDER_MARKER = "usage-terse-reminder"
 _TERSE_REMINDER_MARKERS = (_TERSE_REMINDER_MARKER, "usage_terse_reminder")
 # Independent, opt-in Claude Code UserPromptSubmit hook.
 QUOTA_AWARE_HOOK_TARGET = Path(os.path.expanduser("~/.claude/usage-quota-aware.py"))
-QUOTA_AWARE_HOOK_VERSION = "1.2"
+QUOTA_AWARE_HOOK_VERSION = "1.3"
 QUOTA_AWARE_MATCHER = ""
 _QUOTA_AWARE_MARKER = "usage-quota-aware"
 _QUOTA_AWARE_MARKERS = (_QUOTA_AWARE_MARKER, "usage_quota_aware")

usage_cli-0.34.0/loaders/muse_quota_probe.py

@@ -0,0 +1,276 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (C) 2026 lollapalooza <https://github.com/aqua5230>
+
+"""Read shared Muse quota snapshots and schedule bounded background probes."""
+
+from __future__ import annotations
+
+import atexit
+import json
+import logging
+import math
+import os
+import shutil
+import subprocess
+import tempfile
+import threading
+import time
+from contextlib import suppress
+from pathlib import Path
+from typing import TypedDict, TypeGuard
+
+from loaders import muse_loader
+
+logger = logging.getLogger(__name__)
+CACHE_PATH = Path.home() / ".usage/muse_quota.json"
+PROBE_DIR = Path.home() / ".usage/muse-probe"
+MUSE_MODEL = "muse-spark-1.3"
+STALE_SECONDS = 30 * 60
+_probe_lock = threading.Lock()
+_probe_running = False
+_retry_after = 0.0
+_last_attempt_session: float | None = None
+_probe_process: subprocess.Popen[str] | None = None
+_probe_shutdown = False
+
+
+class MuseQuotaWindow(TypedDict):
+    used_percent: float
+    resets_at: float
+
+
+class MuseQuotaResult(TypedDict):
+    checked_at: float
+    window: MuseQuotaWindow
+    weekly: MuseQuotaWindow
+
+
+def find_muse() -> str | None:
+    """Find Muse even when the app inherits a limited GUI PATH."""
+    executable = shutil.which("muse")
+    if executable is not None:
+        return executable
+    for candidate in ("~/.local/bin/muse", "/opt/homebrew/bin/muse", "/usr/local/bin/muse"):
+        expanded = os.path.expanduser(candidate)
+        if os.path.isfile(expanded) and os.access(expanded, os.X_OK):
+            return expanded
+    return None
+
+
+def _number(value: object) -> TypeGuard[int | float]:
+    if isinstance(value, bool) or not isinstance(value, int | float):
+        return False
+    try:
+        return math.isfinite(float(value))
+    except OverflowError:
+        return False
+
+
+def validate_muse_cache(payload: object) -> MuseQuotaResult | None:
+    if not isinstance(payload, dict) or not _number(payload.get("checked_at")):
+        return None
+    windows: list[MuseQuotaWindow] = []
+    for name in ("window", "weekly"):
+        window = payload.get(name)
+        if not isinstance(window, dict):
+            return None
+        used, reset = window.get("used_percent"), window.get("resets_at")
+        if not _number(used) or not _number(reset) or not 0 <= used <= 100:
+            return None
+        windows.append(MuseQuotaWindow(used_percent=float(used), resets_at=float(reset)))
+    return MuseQuotaResult(
+        checked_at=float(payload["checked_at"]), window=windows[0], weekly=windows[1]
+    )
+
+
+def parse_muse_allowance(stdout: str, checked_at: float) -> MuseQuotaResult | None:
+    for line in stdout.splitlines():
+        try:
+            record = json.loads(line)
+            if not isinstance(record, dict) or record.get("payload_type") != "run.usage":
+                continue
+            allowance = record["payload"]["allowance"]
+            payload: dict[str, object] = {"checked_at": checked_at}
+            for name in ("window", "weekly"):
+                raw = allowance[name]
+                if not _number(raw["resets_at_ms"]):
+                    break
+                payload[name] = {
+                    "used_percent": raw["used_percent"],
+                    "resets_at": raw["resets_at_ms"] / 1000,
+                }
+            result = validate_muse_cache(payload)
+            if result is not None:
+                return result
+        except (ValueError, KeyError, TypeError, OverflowError, RecursionError):
+            continue
+    return None
+
+
+def read_cache() -> MuseQuotaResult | None:
+    """Ignore invalid shared snapshots without deleting or quarantining them."""
+    try:
+        return validate_muse_cache(json.loads(CACHE_PATH.read_text(encoding="utf-8")))
+    except (OSError, ValueError, OverflowError, RecursionError):
+        return None
+
+
+def latest_session_mtime() -> float | None:
+    latest = None
+    for path in muse_loader.session_paths():
+        try:
+            modified = path.stat().st_mtime
+        except OSError:
+            continue
+        latest = modified if latest is None else max(latest, modified)
+    return latest
+
+
+def is_stale(quota: MuseQuotaResult, latest: float | None, now: float) -> bool:
+    return (
+        latest is not None
+        and latest > quota["checked_at"]
+        and now - quota["checked_at"] > STALE_SECONDS
+    )
+
+
+def _write_cache(result: MuseQuotaResult) -> None:
+    temporary_path = None
+    try:
+        CACHE_PATH.parent.mkdir(parents=True, exist_ok=True)
+        fd, temporary_path = tempfile.mkstemp(dir=CACHE_PATH.parent, suffix=".tmp")
+        with os.fdopen(fd, "w", encoding="utf-8") as snapshot:
+            json.dump(result, snapshot)
+        os.replace(temporary_path, CACHE_PATH)
+        temporary_path = None
+    finally:
+        if temporary_path is not None:
+            with suppress(OSError):
+                os.unlink(temporary_path)
+
+
+def _stop_process(process: subprocess.Popen[str]) -> None:
+    if process.poll() is not None:
+        return
+    try:
+        process.terminate()
+        try:
+            process.wait(timeout=5)
+        except subprocess.TimeoutExpired:
+            process.kill()
+            process.wait()
+    except OSError:
+        logger.warning("Could not stop Muse quota probe", exc_info=True)
+
+
+def _cleanup_probe() -> None:
+    global _probe_shutdown
+    with _probe_lock:
+        _probe_shutdown = True
+        process = _probe_process
+    if process is not None:
+        _stop_process(process)
+
+
+atexit.register(_cleanup_probe)
+
+
+def _probe_worker(executable: str) -> None:
+    global _probe_running, _retry_after, _probe_process
+    succeeded = False
+    process = None
+    try:
+        PROBE_DIR.mkdir(parents=True, exist_ok=True)
+        with _probe_lock:
+            if _probe_shutdown:
+                return
+            process = subprocess.Popen(
+                [
+                    executable,
+                    "exec",
+                    "--model",
+                    MUSE_MODEL,
+                    "--reasoning-effort",
+                    "low",
+                    "--trust-workspace",
+                    "--disable-web-tools",
+                    "--no-session-log",
+                    "--json",
+                    "Reply with OK only.",
+                ],
+                stdin=subprocess.DEVNULL,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                encoding="utf-8",
+                cwd=PROBE_DIR,
+            )
+            _probe_process = process
+        try:
+            stdout, _ = process.communicate(timeout=120)
+        except subprocess.TimeoutExpired:
+            process.kill()
+            process.communicate()
+            raise
+        result = parse_muse_allowance(stdout, time.time()) if process.returncode == 0 else None
+        if result is not None:
+            _write_cache(result)
+            succeeded = True
+        else:
+            logger.warning(
+                "Muse quota probe returned no valid allowance (exit %s)", process.returncode
+            )
+    except (OSError, subprocess.SubprocessError, UnicodeError):
+        logger.warning("Muse quota probe failed", exc_info=True)
+    finally:
+        if process is not None:
+            _stop_process(process)
+        with _probe_lock:
+            _probe_process = None
+            if not succeeded:
+                _retry_after = time.monotonic() + STALE_SECONDS
+            _probe_running = False
+
+
+def load_quota_snapshot(*, allow_probe: bool = True) -> tuple[MuseQuotaResult | None, float | None]:
+    """Read sessions once and return the snapshot plus its projection context.
+
+    ``allow_probe=False`` only reads: a probe spends Muse quota, so a hidden card never starts one.
+    """
+    global _probe_running, _retry_after, _last_attempt_session
+    cached = read_cache()
+    executable = find_muse()
+    if executable is None:
+        return None, None
+    latest = latest_session_mtime()
+    if (
+        not allow_probe
+        or latest is None
+        or (cached is not None and not is_stale(cached, latest, time.time()))
+    ):
+        return cached, latest
+    with _probe_lock:
+        # A worker may have finished since the first cache read.
+        cached = read_cache()
+        if (
+            latest is None
+            or (cached is not None and not is_stale(cached, latest, time.time()))
+            or _probe_running
+            or _probe_shutdown
+            or time.monotonic() < _retry_after
+            or (_last_attempt_session is not None and latest <= _last_attempt_session)
+        ):
+            return cached, latest
+        _probe_running = True
+        _last_attempt_session = latest
+        try:
+            threading.Thread(target=_probe_worker, args=(executable,), daemon=True).start()
+        except RuntimeError:
+            _probe_running = False
+            _retry_after = time.monotonic() + STALE_SECONDS
+            logger.warning("Could not start Muse quota probe thread", exc_info=True)
+    return cached, latest
+
+
+def load_quota() -> MuseQuotaResult | None:
+    """Return the current snapshot immediately; at most one worker may refresh it."""
+    return load_quota_snapshot()[0]

{usage_cli-0.33.9 → usage_cli-0.34.0}/menubar/agy.py

@@ -58,6 +58,7 @@ class AgyQuotaProjection:
     stale: AgyStaleState | None
     five_hour: AgyQuotaWindow | None
     group_switchable: bool = False
+    weekly_only: bool = False
 
 
 @dataclass(frozen=True, slots=True)
@@ -153,6 +154,7 @@ def project_quota(
     return AgyQuotaProjection(
         group_name=selected.name,
         group_switchable=len(quota.groups) >= 2,
+        weekly_only=_matches_group(selected.name, "argon"),
         session=session,
         weekly=weekly,
         stale=stale,

{usage_cli-0.33.9 → usage_cli-0.34.0}/menubar/app.py

@@ -89,6 +89,7 @@ from menubar.prefs import (
     _hide_claude_enabled,
     _hide_codex_enabled,
     _hide_grok_enabled,
+    _hide_muse_enabled,
     _quota_card_order,
     _quota_notification_thresholds,
     _quota_notifications_enabled,
@@ -507,6 +508,9 @@ class AppDelegate(NSObject):
     def toggleHideGrok_(self, sender: Any) -> None:
         self._toggle_hide_section(sender, "hide_grok_section", "hide_grok", _hide_grok_enabled)
 
+    def toggleHideMuse_(self, sender: Any) -> None:
+        self._toggle_hide_section(sender, "hide_muse_section", "hide_muse", _hide_muse_enabled)
+
     def toggleQuotaNotifications_(self, sender: Any) -> None:
         self._mark_switch_menu_action()
         prefs = _load_preferences()
@@ -844,25 +848,7 @@ class AppDelegate(NSObject):
 
     def _process_quota_notifications(self, state: PopoverState) -> None:
         try:
-            events = self._quota_notifier.update(
-                {
-                    "claude_session": (
-                        state.claude_session.percent,
-                        state.claude_session.available,
-                    ),
-                    "claude_weekly": (state.claude_weekly.percent, state.claude_weekly.available),
-                    "codex_session": (state.codex_session.percent, state.codex_session.available),
-                    "codex_weekly": (state.codex_weekly.percent, state.codex_weekly.available),
-                    "agy_session": (
-                        state.agy_session.percent,
-                        state.agy_session.available and state.agy_stale is None,
-                    ),
-                    "agy_weekly": (
-                        state.agy_weekly.percent,
-                        state.agy_weekly.available and state.agy_stale is None,
-                    ),
-                }
-            )
+            events = self._quota_notifier.update(menubar_notify.notification_channels(state))
             for event in events:
                 if _quota_notifications_enabled() and not self.mock:
                     self._send_quota_notification(event, state)