usage-cli 0.33.0__tar.gz → 0.33.2__tar.gz

{usage_cli-0.33.0 → usage_cli-0.33.2}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.33.0
+Version: 0.33.2
 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: zstandard<1.0.0,>=0.25.0
 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
 - **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
 - **Muse Code Spending:** Muse Code's per-request tokens and cost count toward today's cost, project totals, the HTML report, and the `usage` CLI, read from its own local session logs. Muse keeps no local quota data, so there is no Muse quota card.
 - **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages. 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.
+- **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. The context figure turns yellow at 50% or 200K tokens and red at 80% or 400K tokens, whichever comes first. When it changes color, the status line shows the image count and the estimated share of files and command output.
 - **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.
 
@@ -78,15 +79,16 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
 - **Claude Code side pane (macOS and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
-- **Beginner Mode (macOS):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip 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; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
-- **Quota-Aware Mode (macOS):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
-- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
+- **Beginner Mode (macOS and Windows):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip 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; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
+- **Quota-Aware Mode (macOS and Windows):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
+- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.8 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
 - **Terminal Integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
 
 ### Stay Current
 
 - **AI Update Daily:** Opens a daily-updated public [page](https://aqua5230.github.io/ai-updates/) covering Claude Code, Codex, and Antigravity, with the full history kept. Reviewed items get a plain-language summary in all five UI languages; unreviewed ones show the original source text.
+- **Release Notes After an Update:** The first launch after an update shows what changed in that version in your UI language, once. Fresh installs skip it.
 
 ### Reporting & Insight
 
@@ -101,6 +103,8 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ## Privacy & Data Sources
 
+Claude Desktop chat quota is also supported without installing the standalone Claude Code CLI or configuring a status line. Keep Claude Desktop open: when Claude Code quota files are unavailable, usage reads its local `plan-usage-history.json` (including Microsoft Store installations on Windows). When a recent response in its local Chromium block-file HTTP cache matches the organization, usage also reads the exact session and weekly reset times. Newer cached observations take precedence over throttled history samples; older cache must match the percentages. Missing, unsupported, expired, or inconsistent cache data leaves the countdown unknown; times are never estimated. Desktop samples normally update every 5–15 minutes. The panel shows the observation age, marks it stale after 30 minutes, and stops displaying it after two hours. The most recent organization sample is used; custom desktop profiles are not discovered. No cookies, login tokens, or API calls are needed. These quota caches contain no per-project token counts. Desktop sessions that also write compatible Claude Code logs under `~/.claude/projects/` are counted by the existing project/token reports.
+
 - Claude Code and Codex numbers are read from local log files on your machine.
 - Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
@@ -109,7 +113,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
+- Local usage data from Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app with plan-usage history.
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -161,11 +165,13 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 - **Quotas:** Your 5-hour and weekly limits.
 - **Claude conversations:** Conversations waiting for your permission or MCP input are marked in yellow.
+- **Conversation notifications:** A notification appears when another Claude conversation finishes or starts waiting for you.
+- **Latest reply:** Each conversation row shows the latest assistant reply on its second line.
 - **Background jobs:** Includes subagents started by Claude with the Agent tool and their status.
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**. On macOS it sits under the **Claude Code** submenu as **Side pane**.
+1. In the usage menu bar menu (macOS) or system-tray menu (Windows), open the **Claude Code** submenu and check **Side pane**.
 2. Open a new conversation or run `/reload-plugins`.
 3. At terminal widths ≥144 columns, the pane opens on the right automatically. In narrower terminals, enter `/usage-dash`.
 
@@ -185,7 +191,7 @@ Windows has the full core experience: the system-tray UI, Claude Code status-lin
 
 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.
+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. Right-click the label to open the same menu as the tray icon.
 
 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.33.0 → usage_cli-0.33.2}/README.md

@@ -48,7 +48,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **Grok CLI Support:** A fourth card reads Grok CLI's weekly credit percentage straight from its own local debug log. Grok CLI doesn't expose session or burn-rate data, so the card shows a single weekly bar; its per-request token usage still counts toward today's cost and project totals like Claude Code and Codex.
 - **Muse Code Spending:** Muse Code's per-request tokens and cost count toward today's cost, project totals, the HTML report, and the `usage` CLI, read from its own local session logs. Muse keeps no local quota data, so there is no Muse quota card.
 - **Service Status Alerts:** An orange-red banner appears when Claude Code, Claude API, or Codex API has an outage or degraded performance, read from their public Statuspage.io pages. 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.
+- **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. The context figure turns yellow at 50% or 200K tokens and red at 80% or 400K tokens, whichever comes first. When it changes color, the status line shows the image count and the estimated share of files and command output.
 - **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.
 
@@ -57,15 +57,16 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - **Progress Concierge:** Open a new Claude Code session and `usage` hands your last progress straight to the AI, including your last request, uncommitted changes, and unfinished todos. No `/resume`, no recap. When you do `/resume` a conversation that sat long enough for its cache to expire, it warns you how many tokens the next message will re-send and suggests `/compact` first. Off by default.
 - **Token Saver:** A menu-bar toggle asks Claude Code and Codex to answer more tersely and in plainer language, saving output tokens while keeping code and error messages byte-exact. A light reminder keeps long conversations from drifting back to verbose — in an A/B test on real sessions, late replies stayed ~40% shorter instead of drifting 84% longer.
 - **Claude Code side pane (macOS and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
-- **Beginner Mode (macOS):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip 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; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
-- **Quota-Aware Mode (macOS):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
-- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.5 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
+- **Beginner Mode (macOS and Windows):** Off by default. After Claude Code answers, up to three technical terms from that answer appear above the prompt, each with a one-line plain explanation in your UI language. Press 9 to mark them understood; terms you skip 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; a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, so it uses a little Claude quota, and it pauses while your 5-hour quota is at 90% or more.
+- **Quota-Aware Mode (macOS and Windows):** Off by default. When a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%, Claude Code gets one line with what is left and when it resets. Before a big task, Claude then tells you and lets you pick a smaller part or wait for the reset. It covers Claude Code, Codex, and Antigravity quota, says each level once per conversation, and makes no extra model calls.
+- **Auto-start 5-hour Session:** Off by default. Turn it on and, right after a 5-hour quota resets, `usage` sends one tiny message to each tool (Claude with Haiku, Antigravity with Gemini 3.8 Flash Low, Codex with its cheapest model) so the next 5-hour window starts counting right away. Those messages do use a little quota, but the amount is negligible. Checking your quota never sends a message; only this switch does.
 - **Terminal Integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to any tool that can run a command — Starship, tmux, or your own scripts. Reads the same local files as the menu bar. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
 - **Token-waste Health Check:** A daily background diagnosis scans your logs for waste, including repeated file reads, polluter directories, and noisy Bash output. If it finds issues, a one-line heads-up appears; say "show me" and the AI walks you through fixes.
 
 ### Stay Current
 
 - **AI Update Daily:** Opens a daily-updated public [page](https://aqua5230.github.io/ai-updates/) covering Claude Code, Codex, and Antigravity, with the full history kept. Reviewed items get a plain-language summary in all five UI languages; unreviewed ones show the original source text.
+- **Release Notes After an Update:** The first launch after an update shows what changed in that version in your UI language, once. Fresh installs skip it.
 
 ### Reporting & Insight
 
@@ -80,6 +81,8 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 ## Privacy & Data Sources
 
+Claude Desktop chat quota is also supported without installing the standalone Claude Code CLI or configuring a status line. Keep Claude Desktop open: when Claude Code quota files are unavailable, usage reads its local `plan-usage-history.json` (including Microsoft Store installations on Windows). When a recent response in its local Chromium block-file HTTP cache matches the organization, usage also reads the exact session and weekly reset times. Newer cached observations take precedence over throttled history samples; older cache must match the percentages. Missing, unsupported, expired, or inconsistent cache data leaves the countdown unknown; times are never estimated. Desktop samples normally update every 5–15 minutes. The panel shows the observation age, marks it stale after 30 minutes, and stops displaying it after two hours. The most recent organization sample is used; custom desktop profiles are not discovered. No cookies, login tokens, or API calls are needed. These quota caches contain no per-project token counts. Desktop sessions that also write compatible Claude Code logs under `~/.claude/projects/` are counted by the existing project/token reports.
+
 - Claude Code and Codex numbers are read from local log files on your machine.
 - Antigravity quota requires network access, and only if you use it: quota is fetched from Google's official quota endpoint using the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` reads that credential without writing it back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
 - Background network activity: the Antigravity quota/token endpoints above, public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (falls back to built-in prices offline), and occasionally checking GitHub for a new version. Claude Code and Codex log contents are never uploaded.
@@ -88,7 +91,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 ## Requirements
 
 - macOS 12 (Monterey) or newer, or Windows 10/11
-- Claude Code, Codex, Antigravity, or Grok CLI has been used at least once (so local usage data exists).
+- Local usage data from Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app with plan-usage history.
 - (Source runs only) Python 3.13.
 
 ## Install
@@ -140,11 +143,13 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 - **Quotas:** Your 5-hour and weekly limits.
 - **Claude conversations:** Conversations waiting for your permission or MCP input are marked in yellow.
+- **Conversation notifications:** A notification appears when another Claude conversation finishes or starts waiting for you.
+- **Latest reply:** Each conversation row shows the latest assistant reply on its second line.
 - **Background jobs:** Includes subagents started by Claude with the Agent tool and their status.
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**. On macOS it sits under the **Claude Code** submenu as **Side pane**.
+1. In the usage menu bar menu (macOS) or system-tray menu (Windows), open the **Claude Code** submenu and check **Side pane**.
 2. Open a new conversation or run `/reload-plugins`.
 3. At terminal widths ≥144 columns, the pane opens on the right automatically. In narrower terminals, enter `/usage-dash`.
 
@@ -164,7 +169,7 @@ Windows has the full core experience: the system-tray UI, Claude Code status-lin
 
 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.
+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. Right-click the label to open the same menu as the tray icon.
 
 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.33.2/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,96 @@
+# 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.
+
+
+## Python Zstandard
+
+The local Claude HTTP cache reader uses python-zstandard, including its bundled
+Zstandard library, under their BSD licenses.
+
+Copyright (c) 2016, Gregory Szorc
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+## Zstandard
+
+BSD License
+
+For Zstandard software
+
+Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook, nor Meta, nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

{usage_cli-0.33.0 → usage_cli-0.33.2}/adapters/agy.py

@@ -8,7 +8,7 @@ from __future__ import annotations
 
 from loaders import agy_loader as shared_agy_loader
 
-from i18n import t
+from usage_common.i18n import t
 
 from .types import AgentInfo, UsageEntry
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/adapters/claude.py

@@ -15,7 +15,7 @@ from typing import Any
 
 from loaders.claude_paths import claude_config_dirs
 from loaders.jsonl_utils import iter_jsonl_dicts
-from project_resolver import resolve_project_name
+from usage_common.project_resolver import resolve_project_name
 
 from .types import AgentInfo
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/adapters/grok.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 from loaders import grok_loader as shared_grok_loader
 from loaders.history_loader import UsageEntry as GrokUsageEntry
 
-from i18n import t
+from usage_common.i18n import t
 
 from .types import AgentInfo, UsageEntry
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/adapters/muse.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 from loaders import muse_loader
 from loaders.history_loader import UsageEntry as MuseUsageEntry
 
-from i18n import t
+from usage_common.i18n import t
 
 from .types import AgentInfo, UsageEntry
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/adapters/rate_limits.py

@@ -10,6 +10,8 @@ import os
 from datetime import datetime, timezone
 from typing import Any
 
+from loaders import claude_usage as usage_client
+
 from .types import RateLimits
 
 STATUS_FILE = os.path.expanduser("~/.claude/usage-status.json")
@@ -42,8 +44,12 @@ def _read_status() -> dict[str, Any] | None:
 
 def load_rate_limits() -> RateLimits | None:
     data = _read_status()
-    if data is None:
-        return None
+    if data is None or not usage_client._has_complete_rate_limits(data):
+        snapshot = usage_client.read_quota_fallback()
+        if snapshot is not None:
+            return _snapshot_rate_limits(snapshot)
+        if data is None:
+            return None
 
     rl = data.get("rate_limits") or {}
     five = rl.get("five_hour") or {}
@@ -74,3 +80,18 @@ def load_rate_limits() -> RateLimits | None:
         model=model_name,
         updated_at=data.get("_received_at", ""),
     )
+
+
+def _snapshot_rate_limits(quota: usage_client.UsageSnapshot) -> RateLimits:
+    return RateLimits(
+        five_hour_pct=quota.current_percent,
+        seven_day_pct=quota.weekly_percent,
+        five_hour_resets_at=int(quota.current_reset_at)
+        if quota.current_reset_at is not None
+        else None,
+        seven_day_resets_at=int(quota.weekly_reset_at)
+        if quota.weekly_reset_at is not None
+        else None,
+        model="",
+        updated_at=datetime.fromtimestamp(quota.polled_at, timezone.utc).isoformat(),
+    )

{usage_cli-0.33.0 → usage_cli-0.33.2}/analyzer/aggregator.py

@@ -7,7 +7,7 @@
 from collections import defaultdict
 
 from adapters.types import DailyStats, MonthlyStats, SessionStats, UsageEntry, WeeklyStats
-from pricing import calculate_cost
+from usage_common.pricing import calculate_cost
 
 
 def aggregate_daily(entries: list[UsageEntry]) -> list[DailyStats]:

{usage_cli-0.33.0 → usage_cli-0.33.2}/analyzer/blocks.py

@@ -8,7 +8,7 @@ from collections.abc import Sequence
 from datetime import datetime, timedelta, timezone
 
 from adapters.types import DailyStats, P90Limits, SessionBlock, UsageEntry
-from pricing import calculate_cost
+from usage_common.pricing import calculate_cost
 
 BLOCK_DURATION = timedelta(hours=5)
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/analyzer/persona_loader.py

@@ -17,7 +17,7 @@ from typing import Any
 
 from loaders.claude_paths import claude_config_dirs
 from loaders.jsonl_utils import iter_jsonl_dicts
-from project_resolver import project_from_encoded_path, resolve_project_name
+from usage_common.project_resolver import project_from_encoded_path, resolve_project_name
 from usage_common.time_utils import parse_optional_iso8601_utc
 
 logger = logging.getLogger(__name__)

{usage_cli-0.33.0 → usage_cli-0.33.2}/analyzer/reporter.py

@@ -24,7 +24,7 @@ from analyzer import persona_loader
 from analyzer import subscription
 from adapters import agy, claude, codex, grok, muse
 from adapters.types import AgentInfo, UsageEntry
-from pricing import calculate_cost, is_model_priced
+from usage_common.pricing import calculate_cost, is_model_priced
 
 from .aggregator import aggregate_sessions
 from . import diagnoser, dispatch_ledger, usage_snapshot

{usage_cli-0.33.0 → usage_cli-0.33.2}/analyzer/usage_snapshot.py

@@ -27,7 +27,7 @@ from typing import NotRequired, TypeGuard, TypedDict
 
 from adapters.types import UsageEntry
 from loaders import cache_quarantine
-from pricing import calculate_cost
+from usage_common.pricing import calculate_cost
 
 logger = logging.getLogger(__name__)
 

{usage_cli-0.33.0 → usage_cli-0.33.2}/i18n.json

@@ -52,11 +52,6 @@
     "hook_installed_restart": "已安裝完成，請重開 Claude Code 一次",
     "hook_install_failed": "安裝 hook 失敗",
     "hook_install_failed_default": "setup_hook.setup() 回傳失敗",
-    "repair_dialog_title": "狀態列設定衝突",
-    "repair_dialog_message": "偵測到其他工具佔用了 Claude Code 狀態列。\n要切換成共存模式嗎？usage app 與其他工具可以同時運作。",
-    "repair_dialog_repair": "立即修復",
-    "repair_dialog_skip": "稍後再說",
-    "repair_dialog_never": "不要再問",
     "alert_forwarder_title": "啟用共存模式？",
     "alert_forwarder_body": "偵測到其他 Claude Code 狀態列工具。啟用共存模式後，usage 會透過轉發器與現有工具一起運作。",
     "alert_forwarder_enable": "啟用共存模式",
@@ -69,7 +64,7 @@
     "awaiting_rate_limits": "請對 Claude Code 發送一句訊息以同步配額",
     "hook_broken_not_installed": "⚠ 狀態列沒在更新，請按「設定狀態列」重新安裝",
     "hook_broken_restart": "⚠ 狀態列沒在運作，請重開一次 Claude Code",
-    "usage_status_missing": "⚠ 找不到狀態檔，請按「設定狀態列」，再打開一次 Claude Code",
+    "usage_status_missing": "尚無額度資料。請保持 Claude 桌面版開啟，或設定狀態列後啟動終端機的 Claude Code。",
     "usage_status_missing_active": "⚠ 配額資料只能靠終端機的狀態列同步，桌面版／背景工作階段不會觸發，請開一次終端機的 Claude Code 來同步",
     "usage_status_no_quota": "⚠ 狀態檔尚無配額資料，等 Claude Code 再刷新一次 statusLine",
     "status_error": "錯誤 ({message})",
@@ -542,7 +537,9 @@
     "quota_aware_enabled_msg": "已開啟額度感知模式。請重啟 Claude Code 套用。",
     "quota_aware_disabled_msg": "已關閉額度感知模式。請重啟 Claude Code 套用。",
     "quota_aware_action_failed": "無法切換額度感知模式。",
-    "claude_beginner_error": "新手模式：{error}"
+    "claude_beginner_error": "新手模式：{error}",
+    "claude_desktop_updated": "Claude 桌面版 · {minutes} 分鐘前更新",
+    "claude_desktop_stale": "Claude 桌面版 · 資料過期 · {minutes} 分鐘前更新"
   },
   "en": {
     "panel_default_name": "Default",
@@ -597,11 +594,6 @@
     "hook_installed_restart": "Hook installed. Restart Claude Code once.",
     "hook_install_failed": "Hook installation failed",
     "hook_install_failed_default": "setup_hook.setup() returned failure",
-    "repair_dialog_title": "Status Line Conflict",
-    "repair_dialog_message": "Another tool is using the Claude Code status line.\nSwitch to coexistence mode? usage app can run alongside other tools.",
-    "repair_dialog_repair": "Repair Now",
-    "repair_dialog_skip": "Later",
-    "repair_dialog_never": "Do Not Ask Again",
     "alert_forwarder_title": "Enable coexistence mode?",
     "alert_forwarder_body": "Another Claude Code status line tool was detected. In coexistence mode, usage runs through a forwarder alongside your existing tool.",
     "alert_forwarder_enable": "Enable Coexistence Mode",
@@ -614,7 +606,7 @@
     "awaiting_rate_limits": "Send a message in Claude Code to sync your quota",
     "hook_broken_not_installed": "⚠ Status line is not updating. Click \"Set Up Status Line\" to reinstall it.",
     "hook_broken_restart": "⚠ Status line hook is not running. Restart Claude Code once.",
-    "usage_status_missing": "⚠ Status file not found. Click \"Set Up Status Line\", then open Claude Code once.",
+    "usage_status_missing": "No quota data yet. Keep Claude Desktop open, or set up the status line and start Claude Code in a terminal.",
     "usage_status_missing_active": "⚠ Quota data only syncs via the terminal status line — the desktop app and headless sessions don't trigger it. Open Claude Code in a terminal once to sync.",
     "usage_status_no_quota": "⚠ Status file has no quota data yet. Wait for Claude Code to refresh statusLine once.",
     "status_error": "Error ({message})",
@@ -1087,7 +1079,9 @@
     "quota_aware_enabled_msg": "Quota-Aware Mode enabled. Restart Claude Code to apply.",
     "quota_aware_disabled_msg": "Quota-Aware Mode disabled. Restart Claude Code to apply.",
     "quota_aware_action_failed": "Could not change Quota-Aware Mode.",
-    "claude_beginner_error": "Beginner Mode: {error}"
+    "claude_beginner_error": "Beginner Mode: {error}",
+    "claude_desktop_updated": "Claude Desktop · updated {minutes}m ago",
+    "claude_desktop_stale": "Claude Desktop · stale · updated {minutes}m ago"
   },
   "zh-CN": {
     "panel_default_name": "默认",
@@ -1142,11 +1136,6 @@
     "hook_installed_restart": "已安装完成，请重开 Claude Code 一次",
     "hook_install_failed": "安装 hook 失败",
     "hook_install_failed_default": "setup_hook.setup() 返回失败",
-    "repair_dialog_title": "状态栏设置冲突",
-    "repair_dialog_message": "检测到其他工具占用了 Claude Code 状态栏。\n要切换成共存模式吗？usage app 可以和其他工具同时运行。",
-    "repair_dialog_repair": "立即修复",
-    "repair_dialog_skip": "稍后再说",
-    "repair_dialog_never": "不要再问",
     "alert_forwarder_title": "启用共存模式？",
     "alert_forwarder_body": "检测到其他 Claude Code 状态栏工具。启用共存模式后，usage 会通过转发器和现有工具一起运行。",
     "alert_forwarder_enable": "启用共存模式",
@@ -1159,7 +1148,7 @@
     "awaiting_rate_limits": "请对 Claude Code 发送一句消息以同步配额",
     "hook_broken_not_installed": "⚠ 状态栏没有更新，请点「设置状态栏」重新安装",
     "hook_broken_restart": "⚠ 状态栏没有运行，请重开一次 Claude Code",
-    "usage_status_missing": "⚠ 找不到状态文件，请点「设置状态栏」，再打开一次 Claude Code",
+    "usage_status_missing": "尚无额度数据。请保持 Claude 桌面版打开，或设置状态栏后启动终端中的 Claude Code。",
     "usage_status_missing_active": "⚠ 配额数据只能靠终端的状态栏同步，桌面版／后台会话不会触发，请打开一次终端的 Claude Code 来同步",
     "usage_status_no_quota": "⚠ 状态文件还没有配额数据，等 Claude Code 再刷新一次 statusLine",
     "status_error": "错误 ({message})",
@@ -1632,7 +1621,9 @@
     "quota_aware_enabled_msg": "已开启额度感知模式。请重启 Claude Code 应用。",
     "quota_aware_disabled_msg": "已关闭额度感知模式。请重启 Claude Code 应用。",
     "quota_aware_action_failed": "无法切换额度感知模式。",
-    "claude_beginner_error": "新手模式：{error}"
+    "claude_beginner_error": "新手模式：{error}",
+    "claude_desktop_updated": "Claude 桌面版 · {minutes} 分钟前更新",
+    "claude_desktop_stale": "Claude 桌面版 · 数据过期 · {minutes} 分钟前更新"
   },
   "ja": {
     "panel_default_name": "デフォルト",
@@ -1687,11 +1678,6 @@
     "hook_installed_restart": "フックをインストールしました。Claude Code を一度再起動してください。",
     "hook_install_failed": "フックのインストールに失敗しました",
     "hook_install_failed_default": "setup_hook.setup() が失敗を返しました",
-    "repair_dialog_title": "ステータスライン設定の競合",
-    "repair_dialog_message": "別のツールが Claude Code のステータスラインを使用しています。\n共存モードに切り替えますか？usage app と他のツールを同時に動かせます。",
-    "repair_dialog_repair": "今すぐ修復",
-    "repair_dialog_skip": "あとで",
-    "repair_dialog_never": "今後表示しない",
     "alert_forwarder_title": "共存モードを有効にしますか？",
     "alert_forwarder_body": "他の Claude Code ステータスラインツールを検出しました。共存モードでは、usage はフォワーダー経由で既存のツールと一緒に動作します。",
     "alert_forwarder_enable": "共存モードを有効化",
@@ -1704,7 +1690,7 @@
     "awaiting_rate_limits": "Claude Code にメッセージを送信してクォータを同期してください",
     "hook_broken_not_installed": "⚠ ステータスラインが更新されていません。「ステータスラインを設定」を押して再インストールしてください。",
     "hook_broken_restart": "⚠ ステータスライン hook が動作していません。Claude Code を一度再起動してください。",
-    "usage_status_missing": "⚠ ステータスファイルが見つかりません。「ステータスラインを設定」を押してから、Claude Code を一度起動してください。",
+    "usage_status_missing": "利用枠データがありません。Claude デスクトップを開いたままにするか、ステータスラインを設定してターミナルの Claude Code を起動してください。",
     "usage_status_missing_active": "⚠ クォータ情報はターミナルのステータスラインでのみ同期されます。デスクトップアプリやヘッドレスセッションでは同期されません。ターミナルで Claude Code を一度開いてください。",
     "usage_status_no_quota": "⚠ ステータスファイルにクォータデータがまだありません。Claude Code が statusLine をもう一度更新するまでお待ちください。",
     "status_error": "エラー ({message})",
@@ -2177,7 +2163,9 @@
     "quota_aware_enabled_msg": "クォータ認識モードを有効にしました。Claude Code を再起動してください。",
     "quota_aware_disabled_msg": "クォータ認識モードを無効にしました。Claude Code を再起動してください。",
     "quota_aware_action_failed": "クォータ認識モードを切り替えられませんでした。",
-    "claude_beginner_error": "初心者モード：{error}"
+    "claude_beginner_error": "初心者モード：{error}",
+    "claude_desktop_updated": "Claude デスクトップ · {minutes}分前に更新",
+    "claude_desktop_stale": "Claude デスクトップ · 古いデータ · {minutes}分前に更新"
   },
   "ko": {
     "panel_default_name": "기본",
@@ -2232,11 +2220,6 @@
     "hook_installed_restart": "훅 설치가 완료되었습니다. Claude Code를 한 번 다시 시작하세요.",
     "hook_install_failed": "훅 설치에 실패했습니다",
     "hook_install_failed_default": "setup_hook.setup()가 실패를 반환했습니다",
-    "repair_dialog_title": "상태 표시줄 설정 충돌",
-    "repair_dialog_message": "다른 도구가 Claude Code 상태 표시줄을 사용 중입니다.\n공존 모드로 전환할까요? usage app과 다른 도구를 함께 실행할 수 있습니다.",
-    "repair_dialog_repair": "지금 복구",
-    "repair_dialog_skip": "나중에",
-    "repair_dialog_never": "다시 묻지 않기",
     "alert_forwarder_title": "공존 모드를 활성화할까요?",
     "alert_forwarder_body": "다른 Claude Code 상태 표시줄 도구를 감지했습니다. 공존 모드에서는 usage가 포워더를 통해 기존 도구와 함께 실행됩니다.",
     "alert_forwarder_enable": "공존 모드 활성화",
@@ -2249,7 +2232,7 @@
     "awaiting_rate_limits": "Claude Code에 메시지를 보내 할당량을 동기화하세요",
     "hook_broken_not_installed": "⚠ 상태 표시줄이 업데이트되지 않습니다. \"상태 표시줄 설정\"을 눌러 다시 설치하세요.",
     "hook_broken_restart": "⚠ 상태 표시줄 hook이 작동하지 않습니다. Claude Code를 한 번 다시 시작하세요.",
-    "usage_status_missing": "⚠ 상태 파일을 찾을 수 없습니다. \"상태 표시줄 설정\"을 누른 뒤 Claude Code를 한 번 여세요.",
+    "usage_status_missing": "사용 한도 데이터가 없습니다. Claude 데스크톱을 열어 두거나 상태 표시줄을 설정한 뒤 터미널에서 Claude Code를 실행하세요.",
     "usage_status_missing_active": "⚠ 할당량 데이터는 터미널 상태 표시줄로만 동기화됩니다. 데스크톱 앱이나 헤드리스 세션에서는 동기화되지 않습니다. 터미널에서 Claude Code를 한 번 열어주세요.",
     "usage_status_no_quota": "⚠ 상태 파일에 아직 할당량 데이터가 없습니다. Claude Code가 statusLine을 한 번 더 새로 고칠 때까지 기다리세요.",
     "status_error": "오류 ({message})",
@@ -2722,6 +2705,8 @@
     "quota_aware_enabled_msg": "할당량 인식 모드를 켰습니다. Claude Code를 다시 시작해 주세요.",
     "quota_aware_disabled_msg": "할당량 인식 모드를 껐습니다. Claude Code를 다시 시작해 주세요.",
     "quota_aware_action_failed": "할당량 인식 모드를 변경할 수 없습니다.",
-    "claude_beginner_error": "초보자 모드: {error}"
+    "claude_beginner_error": "초보자 모드: {error}",
+    "claude_desktop_updated": "Claude 데스크톱 · {minutes}분 전 업데이트",
+    "claude_desktop_stale": "Claude 데스크톱 · 오래된 데이터 · {minutes}분 전 업데이트"
   }
 }

{usage_cli-0.33.0 → usage_cli-0.33.2}/installer/claude_pane.py

@@ -9,8 +9,8 @@ import shutil
 import sys
 from pathlib import Path
 
-from i18n import t as _t
 from installer import setup_hook
+from usage_common.i18n import t as _t
 from usage_common.usage_lang import detect_lang
 
 INSTALL_DIR = Path.home() / ".usage" / "claude-pane" / "usage-dash"
@@ -62,7 +62,7 @@ def _status_argv() -> list[str]:
             f"import sys;sys.path[:0]=[{resources!r}+'/lib/python{major}{minor}.zip',"
             f"{resources!r}+'/lib/python{major}.{minor}',"
             f"{resources!r}+'/lib/python{major}.{minor}/lib-dynload',{resources!r}];"
-            "import usage_cli;sys.argv=['usage','status','--json'];usage_cli.main()"
+            "from usage_app import cli;sys.argv=['usage','status','--json'];cli.main()"
         )
         return [
             "/usr/bin/env",
@@ -72,16 +72,17 @@ def _status_argv() -> list[str]:
             "-c",
             bootstrap,
         ]
+    root = str(Path(__file__).resolve().parent.parent)
     return [
         sys.executable,
-        str(Path(__file__).resolve().parent.parent / "usage_cli.py"),
-        "status",
-        "--json",
+        "-c",
+        f"import sys;sys.path.insert(0,{root!r});from usage_app import cli;"
+        "sys.argv=['usage','status','--json'];cli.main()",
     ]
 
 
 def _sidecar_text(mod: str = "usage-dash") -> str:
-    from i18n import I18N_PATH
+    from usage_common.i18n import I18N_PATH
 
     bundle = json.loads(I18N_PATH.read_text(encoding="utf-8"))
     english = bundle["en"]