usage-cli 0.32.3__tar.gz → 0.32.5__tar.gz

{usage_cli-0.32.3 → usage_cli-0.32.5}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.3
+Version: 0.32.5
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
 Requires-Dist: pyobjc-framework-Cocoa>=11.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-Quartz>=11.0; sys_platform == "darwin"
 Requires-Dist: pyobjc-framework-UserNotifications>=11.0; sys_platform == "darwin"
@@ -69,7 +70,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **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. 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.
+- **Prompt Cache Health:** The status line shows Claude Code's prompt cache hit rate. For 10 minutes after the cache misses, it also says why — the model changed, the tools changed, you sat idle past the 5-minute TTL, and so on — so you can tell whether the extra tokens came from something you did. The hit rate needs Claude Code 2.1.251 or newer and the reason needs 2.1.260 or newer; on older versions those parts simply don'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
@@ -179,7 +180,9 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon shows the remaining session quota percentage for Claude or Codex. Choose **Tray Display Source → Claude Code / Codex** in the right-click menu or panel menu; the change applies immediately and survives restarts (default: Claude). If Codex has no session window, the icon uses its weekly quota instead and the tooltip identifies that window. Missing quota data shows `--`. The tooltip summarizes both tools, with the selected source first. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click also provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+
+Enable **Show Taskbar Quota** in either menu for a transparent `Codex: 92%` label inside the taskbar, immediately left of the notification area. It follows taskbar position, scaling, and light/dark theme, and hides during fullscreen use or taskbar auto-hide. Click the label to open the panel. If buttons leave insufficient space, it moves just outside the taskbar. The normal app icon remains as a menu entry point; the label follows the selected source and quota window.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 

{usage_cli-0.32.3 → usage_cli-0.32.5}/README.md

@@ -49,7 +49,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **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. 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.
+- **Prompt Cache Health:** The status line shows Claude Code's prompt cache hit rate. For 10 minutes after the cache misses, it also says why — the model changed, the tools changed, you sat idle past the 5-minute TTL, and so on — so you can tell whether the extra tokens came from something you did. The hit rate needs Claude Code 2.1.251 or newer and the reason needs 2.1.260 or newer; on older versions those parts simply don'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
@@ -159,7 +159,9 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.
 
-The system-tray icon updates with your Claude quota percentage; its tooltip summarizes the Claude and Codex windows. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+The system-tray icon shows the remaining session quota percentage for Claude or Codex. Choose **Tray Display Source → Claude Code / Codex** in the right-click menu or panel menu; the change applies immediately and survives restarts (default: Claude). If Codex has no session window, the icon uses its weekly quota instead and the tooltip identifies that window. Missing quota data shows `--`. The tooltip summarizes both tools, with the selected source first. Left-click opens the same 16 quota themes available on macOS (Default plus the other fifteen) in WebView2. Right-click also provides Reset Panel Position and Quit; panel switching, refresh, launch at login, and update checks are in the panel menu.
+
+Enable **Show Taskbar Quota** in either menu for a transparent `Codex: 92%` label inside the taskbar, immediately left of the notification area. It follows taskbar position, scaling, and light/dark theme, and hides during fullscreen use or taskbar auto-hide. Click the label to open the panel. If buttons leave insufficient space, it moves just outside the taskbar. The normal app icon remains as a menu entry point; the label follows the selected source and quota window.
 
 Windows differences: the panel opens at the bottom-right of the working area rather than next to the tray icon; update prompts use a system Yes/No dialog.
 

usage_cli-0.32.5/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,28 @@
+# Third-party notices
+
+The Windows taskbar label anchoring in `wintray/taskbar_overlay.py` is adapted
+from [Codex Usage Widget](https://github.com/ognjeeen/codex-usage-widget),
+commit `940d722d4044242bbe73f8056014449c2ef827a7`, particularly
+`Infrastructure/Windows/TaskbarWindowInterop.cs`.
+
+MIT License
+
+Copyright (c) 2026 Ognjen Marinković
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{usage_cli-0.32.3 → usage_cli-0.32.5}/doctor.py

@@ -20,6 +20,7 @@ from typing import Final
 
 from i18n import packaged_resource_path
 from installer import setup_hook
+from installer.codex_hook_trust import codex_terse_hook_trust
 
 SEPARATOR = "-" * 29
 RATE_LIMIT_FRESH_SECONDS: Final = 15 * 60
@@ -54,6 +55,7 @@ CHECK_LABELS: Final = {
     CODEX_RATE_LIMITS: "codex rate limits",
     CODEX_HISTORY: "codex history",
     CLAUDE_COST: "claude cost",
+    "codex_terse_hook_trust": "codex terse hook trust",
 }
 
 
@@ -87,6 +89,7 @@ def collect() -> DoctorReport:
         ("optional", _field(CODEX_LOGS, _codex_logs)),
         ("optional", _field(CODEX_RATE_LIMITS, _codex_rate_limits)),
         ("optional", _field(CLAUDE_COST, _claude_cost)),
+        ("optional", _field("codex_terse_hook_trust", _codex_terse_trust)),
     ]
     return DoctorReport(
         version=_text_field(_current_version),
@@ -514,3 +517,8 @@ def _ago(mtime: float) -> str:
         return f"{hours}h"
     days = hours // 24
     return f"{days}d"
+
+
+def _codex_terse_trust() -> CheckResult:
+    trust = codex_terse_hook_trust()
+    return CheckResult("codex_terse_hook_trust", "ok" if trust == "trusted" else "warn", trust)

{usage_cli-0.32.3 → usage_cli-0.32.5}/i18n.json

@@ -22,6 +22,10 @@
     "launch_at_login": "開機自動啟動",
     "reset_panel_position": "重設面板位置",
     "hide_sections_menu": "隱藏區塊",
+    "tray_provider_menu": "系統匣顯示來源",
+    "quota_label_menu": "顯示工作列額度",
+    "quota_label_format": "{provider}: {value}%",
+    "quota_label_unknown": "{provider}: --",
     "quota_notifications_menu": "用量提醒通知",
     "window_keeper_menu": "自動啟動 5 小時計時",
     "window_keeper_tooltip": "5 小時額度重置後，自動各送一則極小訊息（Claude 用 Haiku、agy 用 Gemini 3.5 Flash Low、Codex 用最省成本模型），讓下一輪 5 小時立刻開始計時（會消耗極少量額度）",
@@ -493,7 +497,21 @@
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "剩",
     "claude_pane_reset_done": "已重置",
-    "claude_pane_hours_ago": "{count}時前"
+    "claude_pane_hours_ago": "{count}時前",
+    "update_check_failed_offline": "連不上 GitHub，請確認網路後再試。",
+    "update_check_failed_rate_limited": "GitHub 暫時拒絕請求，可能太頻繁了，稍後再試。",
+    "update_check_failed_server": "GitHub 回應錯誤，稍後再試。",
+    "update_check_failed_bad_response": "GitHub 回傳的資料看不懂，稍後再試。",
+    "agy_signin_expired": "登入過期",
+    "agy_signin_expired_tooltip": "Antigravity 登入已過期，usage 拿不到新額度。在終端機執行一次 agy 重新登入，成功後會自動恢復。",
+    "keeper_failed_title": "自動開窗失敗",
+    "keeper_failed_body": "{tool}：{reason}。下一輪 5 小時沒有開始計時。",
+    "keeper_reason_not_found": "找不到指令",
+    "keeper_reason_timeout": "逾時",
+    "keeper_failed_line": "上次失敗 {time}：{tool}（{reason}）",
+    "terse_codex_hook_untrusted": "Codex 還沒批准 usage 的精簡模式 hook，Codex 那邊不會生效。在 Codex 裡打 /hooks 批准它。",
+    "terse_codex_hook_disabled": "你在 Codex 停用了 usage 的精簡模式 hook。在 Codex 裡打 /hooks 重新啟用。",
+    "claude_pane_stopped": "已停止"
   },
   "en": {
     "panel_default_name": "Default",
@@ -518,6 +536,10 @@
     "launch_at_login": "Launch at Login",
     "reset_panel_position": "Reset panel position",
     "hide_sections_menu": "Hide Sections",
+    "tray_provider_menu": "Tray Display Source",
+    "quota_label_menu": "Show Taskbar Quota",
+    "quota_label_format": "{provider}: {value}%",
+    "quota_label_unknown": "{provider}: --",
     "quota_notifications_menu": "Usage Alert Notifications",
     "window_keeper_menu": "Auto-start 5-hour Session",
     "window_keeper_tooltip": "After your 5-hour quotas reset, automatically send one tiny message to each tool (Claude with Haiku, agy with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour sessions start counting right away (uses a tiny bit of quota).",
@@ -989,7 +1011,21 @@
     "claude_pane_elapsed": "{minutes}m{seconds}s",
     "claude_pane_remaining": "left",
     "claude_pane_reset_done": "Reset",
-    "claude_pane_hours_ago": "{count}h ago"
+    "claude_pane_hours_ago": "{count}h ago",
+    "update_check_failed_offline": "Cannot reach GitHub. Check your connection and try again.",
+    "update_check_failed_rate_limited": "GitHub is limiting requests. Try again later.",
+    "update_check_failed_server": "GitHub returned an error. Try again later.",
+    "update_check_failed_bad_response": "Could not read GitHub’s response. Try again later.",
+    "agy_signin_expired": "Sign-in expired",
+    "agy_signin_expired_tooltip": "Your Antigravity sign-in expired, so usage cannot fetch fresh quota. Run agy in a terminal to sign in again. Quota will recover automatically.",
+    "keeper_failed_title": "Auto-start failed",
+    "keeper_failed_body": "{tool}: {reason}. The next 5-hour window has not started.",
+    "keeper_reason_not_found": "Command not found",
+    "keeper_reason_timeout": "Timed out",
+    "keeper_failed_line": "Last failure {time}: {tool} ({reason})",
+    "terse_codex_hook_untrusted": "Codex has not approved usage’s terse mode hook, so terse mode will not work in Codex. Run /hooks in Codex to approve it.",
+    "terse_codex_hook_disabled": "You disabled usage’s terse mode hook in Codex. Run /hooks in Codex to enable it again.",
+    "claude_pane_stopped": "stopped"
   },
   "zh-CN": {
     "panel_default_name": "默认",
@@ -1014,6 +1050,10 @@
     "launch_at_login": "开机自动启动",
     "reset_panel_position": "重设面板位置",
     "hide_sections_menu": "隐藏区块",
+    "tray_provider_menu": "托盘显示来源",
+    "quota_label_menu": "显示任务栏额度",
+    "quota_label_format": "{provider}: {value}%",
+    "quota_label_unknown": "{provider}: --",
     "quota_notifications_menu": "用量提醒通知",
     "window_keeper_menu": "自动启动 5 小时计时",
     "window_keeper_tooltip": "5 小时额度重置后，自动各发送一则极小消息（Claude 用 Haiku、agy 用 Gemini 3.5 Flash Low、Codex 用最省成本模型），让下一轮 5 小时立刻开始计时（会消耗极少量额度）",
@@ -1485,7 +1525,21 @@
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "剩",
     "claude_pane_reset_done": "已重置",
-    "claude_pane_hours_ago": "{count}时前"
+    "claude_pane_hours_ago": "{count}时前",
+    "update_check_failed_offline": "连不上 GitHub，请确认网络后再试。",
+    "update_check_failed_rate_limited": "GitHub 暂时拒绝请求，可能太频繁了，稍后再试。",
+    "update_check_failed_server": "GitHub 响应错误，稍后再试。",
+    "update_check_failed_bad_response": "GitHub 返回的数据看不懂，稍后再试。",
+    "agy_signin_expired": "登录过期",
+    "agy_signin_expired_tooltip": "Antigravity 登录已过期，usage 无法获取新额度。在终端运行一次 agy 重新登录，成功后会自动恢复。",
+    "keeper_failed_title": "自动开窗失败",
+    "keeper_failed_body": "{tool}：{reason}。下一轮 5 小时没有开始计时。",
+    "keeper_reason_not_found": "找不到命令",
+    "keeper_reason_timeout": "超时",
+    "keeper_failed_line": "上次失败 {time}：{tool}（{reason}）",
+    "terse_codex_hook_untrusted": "Codex 还没批准 usage 的精简模式 hook，Codex 那边不会生效。在 Codex 里输入 /hooks 批准它。",
+    "terse_codex_hook_disabled": "你在 Codex 停用了 usage 的精简模式 hook。在 Codex 里输入 /hooks 重新启用。",
+    "claude_pane_stopped": "已停止"
   },
   "ja": {
     "panel_default_name": "デフォルト",
@@ -1510,6 +1564,10 @@
     "launch_at_login": "ログイン時に起動",
     "reset_panel_position": "パネルの位置をリセット",
     "hide_sections_menu": "セクションを非表示",
+    "tray_provider_menu": "トレイの表示元",
+    "quota_label_menu": "タスクバーにクォータを表示",
+    "quota_label_format": "{provider}: {value}%",
+    "quota_label_unknown": "{provider}: --",
     "quota_notifications_menu": "使用量アラート通知",
     "window_keeper_menu": "5 時間セッションを自動開始",
     "window_keeper_tooltip": "5 時間枠のリセット後、各ツールにごく小さなメッセージを自動送信します（Claude は Haiku、agy は Gemini 3.5 Flash Low、Codex は最も低コストなモデル）。次の 5 時間のカウントをすぐに開始します（ごくわずかな枠を消費します）。",
@@ -1981,7 +2039,21 @@
     "claude_pane_elapsed": "{minutes}分{seconds}秒",
     "claude_pane_remaining": "残り",
     "claude_pane_reset_done": "リセット済み",
-    "claude_pane_hours_ago": "{count}時間前"
+    "claude_pane_hours_ago": "{count}時間前",
+    "update_check_failed_offline": "GitHub に接続できません。ネット接続を確認して再試行してください。",
+    "update_check_failed_rate_limited": "GitHub がリクエストを制限しています。後でもう一度お試しください。",
+    "update_check_failed_server": "GitHub でエラーが発生しました。後でもう一度お試しください。",
+    "update_check_failed_bad_response": "GitHub の応答を読み取れませんでした。後でもう一度お試しください。",
+    "agy_signin_expired": "ログイン期限切れ",
+    "agy_signin_expired_tooltip": "Antigravity のログイン期限が切れたため、usage は新しい利用枠を取得できません。ターミナルで agy を実行して再ログインすると、自動で復旧します。",
+    "keeper_failed_title": "自動開始に失敗",
+    "keeper_failed_body": "{tool}：{reason}。次の 5 時間枠は開始されていません。",
+    "keeper_reason_not_found": "コマンドが見つかりません",
+    "keeper_reason_timeout": "タイムアウト",
+    "keeper_failed_line": "前回の失敗 {time}：{tool}（{reason}）",
+    "terse_codex_hook_untrusted": "Codex が usage の簡潔モード hook をまだ承認していないため、Codex では機能しません。Codex で /hooks を入力して承認してください。",
+    "terse_codex_hook_disabled": "Codex で usage の簡潔モード hook が無効になっています。Codex で /hooks を入力して再び有効にしてください。",
+    "claude_pane_stopped": "停止済み"
   },
   "ko": {
     "panel_default_name": "기본",
@@ -2006,6 +2078,10 @@
     "launch_at_login": "로그인 시 시작",
     "reset_panel_position": "패널 위치 재설정",
     "hide_sections_menu": "섹션 숨기기",
+    "tray_provider_menu": "트레이 표시 소스",
+    "quota_label_menu": "작업 표시줄 할당량 표시",
+    "quota_label_format": "{provider}: {value}%",
+    "quota_label_unknown": "{provider}: --",
     "quota_notifications_menu": "사용량 알림",
     "window_keeper_menu": "5시간 세션 자동 시작",
     "window_keeper_tooltip": "5시간 할당량이 리셋되면 각 도구에 아주 작은 메시지를 자동 전송합니다 (Claude는 Haiku, agy는 Gemini 3.5 Flash Low, Codex는 가장 저렴한 모델). 다음 5시간 카운트를 바로 시작합니다 (극소량의 할당량을 소모합니다).",
@@ -2477,6 +2553,20 @@
     "claude_pane_elapsed": "{minutes}분{seconds}초",
     "claude_pane_remaining": "남음",
     "claude_pane_reset_done": "리셋됨",
-    "claude_pane_hours_ago": "{count}시간 전"
+    "claude_pane_hours_ago": "{count}시간 전",
+    "update_check_failed_offline": "GitHub에 연결할 수 없어요. 인터넷 연결을 확인하고 다시 시도하세요.",
+    "update_check_failed_rate_limited": "GitHub가 요청을 제한하고 있어요. 잠시 후 다시 시도하세요.",
+    "update_check_failed_server": "GitHub에서 오류가 발생했어요. 잠시 후 다시 시도하세요.",
+    "update_check_failed_bad_response": "GitHub 응답을 읽을 수 없어요. 잠시 후 다시 시도하세요.",
+    "agy_signin_expired": "로그인 만료",
+    "agy_signin_expired_tooltip": "Antigravity 로그인이 만료되어 usage가 새 한도를 가져올 수 없어요. 터미널에서 agy를 실행해 다시 로그인하면 자동으로 복구돼요.",
+    "keeper_failed_title": "자동 시작 실패",
+    "keeper_failed_body": "{tool}: {reason}. 다음 5시간 구간이 시작되지 않았습니다.",
+    "keeper_reason_not_found": "명령을 찾을 수 없음",
+    "keeper_reason_timeout": "시간 초과",
+    "keeper_failed_line": "마지막 실패 {time}: {tool} ({reason})",
+    "terse_codex_hook_untrusted": "Codex가 usage의 간결 모드 hook을 아직 승인하지 않아 Codex에서 작동하지 않습니다. Codex에서 /hooks를 입력해 승인하세요.",
+    "terse_codex_hook_disabled": "Codex에서 usage의 간결 모드 hook을 비활성화했습니다. Codex에서 /hooks를 입력해 다시 활성화하세요.",
+    "claude_pane_stopped": "중지됨"
   }
 }

usage_cli-0.32.5/installer/codex_hook_trust.py

@@ -0,0 +1,66 @@
+"""Read Codex's approval record without granting hook trust."""
+
+from __future__ import annotations
+
+import json
+import os
+import tomllib
+
+from installer import session_hooks
+from loaders.codex_paths import codex_home
+
+
+def codex_terse_hook_trust() -> str:
+    """Return the usage SessionStart hook's trust state.
+
+    A trusted_hash alone cannot detect Modified (a hook edited after approval).
+    Codex remains responsible for verifying the hash and asking for approval.
+    """
+    path = session_hooks.CODEX_HOOKS_JSON
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+        if not isinstance(data, dict):
+            return "unknown"
+        groups = session_hooks._codex_session_start_list(data)
+        if groups is None:
+            return "not_installed"
+        index = None
+        for group_index, group in enumerate(groups):
+            handlers = group.get("hooks") if isinstance(group, dict) else None
+            if not isinstance(handlers, list):
+                continue
+            for handler_index, handler in enumerate(handlers):
+                command = handler.get("command") if isinstance(handler, dict) else None
+                if isinstance(command, str) and session_hooks._TERSE_MARKER in command:
+                    index = (group_index, handler_index)
+                    break
+            if index is not None:
+                break
+        if index is None:
+            return "not_installed"
+        with (codex_home() / "config.toml").open("rb") as handle:
+            config = tomllib.load(handle)
+        hooks = config.get("hooks", {})
+        states = hooks.get("state", {}) if isinstance(hooks, dict) else {}
+        if not isinstance(states, dict):
+            return "unknown"
+        suffix = f":session_start:{index[0]}:{index[1]}"
+        entry = states.get(f"{path}{suffix}")
+        if entry is None:
+            entry = next(
+                (
+                    value
+                    for key, value in states.items()
+                    if key.endswith(suffix)
+                    and os.path.realpath(key[: -len(suffix)]) == os.path.realpath(path)
+                ),
+                {},
+            )
+        if not isinstance(entry, dict):
+            return "untrusted"
+        if entry.get("enabled") is False:
+            return "disabled"
+        trusted_hash = entry.get("trusted_hash")
+        return "trusted" if isinstance(trusted_hash, str) and trusted_hash else "untrusted"
+    except (OSError, UnicodeError, ValueError):
+        return "unknown"

{usage_cli-0.32.3 → usage_cli-0.32.5}/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.8"
+HOOK_VERSION = "1.9"
 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.32.3 → usage_cli-0.32.5}/loaders/agy_quota_probe.py

@@ -37,6 +37,19 @@ from urllib.request import Request, urlopen
 from usage_common.subprocess_utils import hidden_console_kwargs
 
 CACHE_PATH = Path(os.path.expanduser("~/.usage/agy_quota_cache.json"))
+AUTH_EXPIRED_PATH = CACHE_PATH.parent / "agy_auth_expired"
+
+
+def auth_expired() -> bool:
+    return AUTH_EXPIRED_PATH.exists()
+
+
+def _mark_auth_expired() -> None:
+    with suppress(OSError):
+        AUTH_EXPIRED_PATH.parent.mkdir(parents=True, exist_ok=True)
+        AUTH_EXPIRED_PATH.touch()
+
+
 # Legacy OAuth token written by older Antigravity CLI versions. Read-only: we
 # never write back here (that is the CLI's home and could corrupt its login).
 _TOKEN_PATH = Path(os.path.expanduser("~/.gemini/antigravity-cli/antigravity-oauth-token"))
@@ -117,7 +130,11 @@ def probe_quota(timeout_seconds: float = 15) -> AgyQuotaResult | None:
     groups_raw = _extract_groups(raw)
     if not groups_raw:
         return None
-    return _build_result(groups_raw)
+    result = _build_result(groups_raw)
+    if result is not None:
+        with suppress(OSError):
+            AUTH_EXPIRED_PATH.unlink(missing_ok=True)
+    return result
 
 
 def find_agy() -> str | None:
@@ -353,6 +370,20 @@ def _refresh_token(refresh_token: str, timeout: float) -> tuple[str, int] | None
         payload = json.loads(raw)
     except HTTPError as exc:
         _handle_http_error(exc)
+        if exc.code == 401:
+            _mark_auth_expired()
+        elif exc.code == 400:
+            try:
+                raw_error = exc.read(_MAX_RESPONSE_BYTES + 1)
+                if len(raw_error) <= _MAX_RESPONSE_BYTES:
+                    error_payload = json.loads(raw_error)
+                    if (
+                        isinstance(error_payload, dict)
+                        and error_payload.get("error") == "invalid_grant"
+                    ):
+                        _mark_auth_expired()
+            except (OSError, ValueError):
+                pass
         return None
     except (URLError, OSError, ValueError):
         return None
@@ -387,6 +418,8 @@ def _post_json(url: str, access_token: str, body: dict[str, object], timeout: fl
         return json.loads(raw)
     except HTTPError as exc:
         _handle_http_error(exc)
+        if exc.code == 401:
+            _mark_auth_expired()
         return None
     except (URLError, OSError, ValueError):
         return None

{usage_cli-0.32.3 → usage_cli-0.32.5}/menubar/agy.py

@@ -18,6 +18,7 @@ from loaders.agy_quota_probe import (
     AgyQuotaGroup,
     AgyQuotaResult,
     AgyQuotaWindow,
+    auth_expired,
     load_quota,
 )
 from loaders.agy_quota_probe import (
@@ -294,6 +295,11 @@ def _window_row(
 
 
 def _stale_state(fetched_at: str, now: float, language: str) -> AgyStaleState | None:
+    if auth_expired():
+        return {
+            "ageText": _t(language, "agy_signin_expired"),
+            "tooltip": _t(language, "agy_signin_expired_tooltip"),
+        }
     try:
         age_seconds = now - parse_iso8601_utc_or_raise(fetched_at).timestamp()
     except (TypeError, ValueError):

{usage_cli-0.32.3 → usage_cli-0.32.5}/menubar/app.py

@@ -85,7 +85,6 @@ from menubar.chrome import (
 )
 from menubar.popover import PopoverViewController, _popover_size
 from menubar.prefs import (
-    _auto_update_check_enabled,
     _hide_agy_enabled,
     _hide_claude_enabled,
     _hide_codex_enabled,
@@ -181,7 +180,6 @@ __all__ = [
     "_missing_row",
     "_quota_row",
     "format_human_time",
-    "_auto_update_check_enabled",
     "_hide_agy_enabled",
     "_hide_claude_enabled",
     "_hide_codex_enabled",
@@ -306,6 +304,7 @@ class AppDelegate(NSObject):
             "agy_session": BurnRateTracker(),
             "agy_weekly": BurnRateTracker(),
         }
+        self._auto_check_schedule = update_gate.AutoCheckSchedule()
         self._quota_notifier = QuotaNotifier(_quota_notification_thresholds())
         self._refresh_in_flight = False
         self._refresh_queued = False
@@ -383,7 +382,7 @@ class AppDelegate(NSObject):
 
     def timerFired_(self, timer: Any) -> None:
         self._refresh()
-        self._clear_stale_update_cache()
+        menubar_update.on_poll_tick(self)
 
     def _reschedule_poll_timer(self, interval: float) -> None:
         if self.timer is not None and self.timer_interval == interval:
@@ -611,19 +610,8 @@ class AppDelegate(NSObject):
     def _maybe_check_update_in_background(self) -> None:
         menubar_update.maybe_check_update_in_background(self)
 
-    def _check_update_in_background(
-        self,
-        *,
-        manual: bool,
-        ignore_cooldown: bool,
-        ignore_skipped: bool,
-    ) -> None:
-        menubar_update.check_update_in_background(
-            self,
-            manual=manual,
-            ignore_cooldown=ignore_cooldown,
-            ignore_skipped=ignore_skipped,
-        )
+    def _check_update_in_background(self) -> bool:
+        return menubar_update.check_update_in_background(self)
 
     def _showUpdateAlert_(self, release: update_checker.ReleaseInfo) -> None:
         alert = _make_alert()
@@ -644,16 +632,6 @@ class AppDelegate(NSObject):
             prefs["update_dismissed_at"] = time.time()
         _save_preferences(prefs)
 
-    def _showNoUpdateAvailable_(self, result: Any) -> None:
-        alert = _make_alert()
-        alert.setMessageText_(_t(self.language, "update_no_new_version"))
-        alert.runModal()
-
-    def _showUpdateCheckFailed_(self, result: Any) -> None:
-        alert = _make_alert()
-        alert.setMessageText_(_t(self.language, "update_check_failed"))
-        alert.runModal()
-
     def _set_active_panel_id(self, panel_id: str) -> None:
         panel = panels.get_panel(panel_id)
         save_active_panel_id(panel.id)
@@ -905,16 +883,7 @@ class AppDelegate(NSObject):
     def _request_notification_authorization(self) -> None:
         if self.mock or not _quota_notifications_enabled():
             return
-        try:
-            center, constants = menubar_notify.user_notification_center()
-            options = constants["badge"] | constants["sound"] | constants["alert"]
-            center.requestAuthorizationWithOptions_completionHandler_(
-                options,
-                lambda granted, error: None,
-            )
-        except Exception:
-            if os.environ.get("USAGE_DEBUG") == "1":
-                logger.warning("notification authorization failed", exc_info=True)
+        menubar_notify.request_notification_authorization()
 
     def _process_quota_notifications(self, state: PopoverState) -> None:
         try:

{usage_cli-0.32.3 → usage_cli-0.32.5}/menubar/menu.py

@@ -51,6 +51,20 @@ def build_menu_item(
         item.setState_(1 if state else 0)
     if tooltip_key is not None:
         item.setToolTip_(_t(language, tooltip_key))
+    if title_key == "window_keeper_menu" and state:
+        from quota.keeper_outcome import failure_tooltip
+
+        failures = failure_tooltip(language)
+        if failures:
+            item.setTitle_(_t(language, title_key) + " ⚠")
+            item.setToolTip_(failures + "\n" + _t(language, "window_keeper_tooltip"))
+    if title_key == "terse_mode_menu" and state:
+        from installer.codex_hook_trust import codex_terse_hook_trust
+
+        trust = codex_terse_hook_trust()
+        if trust in ("untrusted", "disabled"):
+            item.setTitle_(_t(language, title_key) + " ⚠")
+            item.setToolTip_(_t(language, f"terse_codex_hook_{trust}"))
     return item