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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.32.6
+Version: 0.33.0
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -78,6 +78,8 @@ 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.
 - **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.
@@ -102,6 +104,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - 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.
+- 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`.
 
 ## Requirements
 
@@ -162,7 +165,7 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**.
+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**.
 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`.
 
@@ -251,6 +254,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
+| Claude Code Beginner Mode & Quota-Aware Mode | ✅ | — | — |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit

{usage_cli-0.32.6 → usage_cli-0.33.0}/README.md

@@ -57,6 +57,8 @@ 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.
 - **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.
@@ -81,6 +83,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 - 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.
+- 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`.
 
 ## Requirements
 
@@ -141,7 +144,7 @@ See your quota, other conversations, and background jobs without leaving Claude
 
 **How to enable**
 
-1. In the usage menu bar menu (macOS) or the system-tray panel menu (Windows), check **Claude Code side pane**.
+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**.
 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`.
 
@@ -230,6 +233,7 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
 | AI Update Daily | ✅ | — | — |
 | Progress Concierge & Token Saver | ✅ | — | — |
 | Token-waste Health Check | ✅ | — | — |
+| Claude Code Beginner Mode & Quota-Aware Mode | ✅ | — | — |
 | Open-source license | AGPL-3.0 | MIT | — |
 
 ## When usage Isn't the Right Fit

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

@@ -490,6 +490,8 @@
     "claude_pane_sidecar_error": "面板設定讀取失敗：{error}",
     "menu_badge_new": "新",
     "claude_pane_menu": "Claude Code 側邊面板",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "側邊面板",
     "claude_pane_tooltip": "在 Claude Code 顯示額度、對話與背景工作",
     "claude_pane_enabled_msg": "已開啟側邊面板。開新的 Claude Code 對話（或在對話裡打 /reload-plugins）後生效；終端機寬度不夠時打 /usage-dash 叫出面板。",
     "claude_pane_fullscreen_enabled_note": "已一併開啟 Claude Code 的全螢幕介面，讓面板顯示在右側。取消勾選側邊面板時會改回。",
@@ -515,7 +517,32 @@
     "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": "已停止"
+    "claude_pane_stopped": "已停止",
+    "claude_beginner_menu": "新手模式",
+    "claude_beginner_tooltip": "幫你看懂 Claude 的回答：回答完，在輸入框上方用白話提示最多 3 個專有名詞。按 9 標成「懂了」就不再提示，之後開新對話時會出選擇題小考。會用到少量 Claude 額度。",
+    "claude_beginner_title": "名詞提示",
+    "claude_beginner_history_title": "名詞提示紀錄",
+    "claude_beginner_description": "開啟名詞提示紀錄",
+    "claude_beginner_all_known": "都懂了",
+    "claude_beginner_dismiss": "收起",
+    "claude_beginner_known": "懂了",
+    "claude_beginner_unknown": "還不懂",
+    "claude_beginner_empty": "還沒有名詞紀錄。",
+    "claude_beginner_opened": "已開啟名詞提示紀錄。",
+    "claude_beginner_quiz_title": "小考",
+    "claude_beginner_quiz_question": "{term} 是什麼意思？",
+    "claude_beginner_quiz_right": "答對了！{days} 天後再考一次。",
+    "claude_beginner_quiz_done": "答對了！這個詞你已經學會了。",
+    "claude_beginner_quiz_wrong": "答錯了。正確答案：{answer}。這個詞之後會再出現在名詞提示裡。",
+    "claude_beginner_enabled_msg": "已開啟新手模式。重開 Claude Code 後生效。",
+    "claude_beginner_disabled_msg": "已關閉新手模式。重開 Claude Code 後生效。",
+    "claude_beginner_action_failed": "無法切換新手模式",
+    "quota_aware_menu": "額度感知模式",
+    "quota_aware_tooltip": "額度快用完時，Claude 開大任務前會先告訴你剩多少、幾點重置，讓你選先做小的還是等重置。",
+    "quota_aware_enabled_msg": "已開啟額度感知模式。請重啟 Claude Code 套用。",
+    "quota_aware_disabled_msg": "已關閉額度感知模式。請重啟 Claude Code 套用。",
+    "quota_aware_action_failed": "無法切換額度感知模式。",
+    "claude_beginner_error": "新手模式：{error}"
   },
   "en": {
     "panel_default_name": "Default",
@@ -1008,6 +1035,8 @@
     "claude_pane_sidecar_error": "Cannot read pane settings: {error}",
     "menu_badge_new": "New",
     "claude_pane_menu": "Claude Code side pane",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "Side pane",
     "claude_pane_tooltip": "Show quotas, Claude sessions and background jobs in Claude Code",
     "claude_pane_enabled_msg": "Pane enabled. Open a new Claude Code conversation (or run /reload-plugins in a conversation). If the terminal is too narrow, run /usage-dash to open the pane.",
     "claude_pane_fullscreen_enabled_note": "Claude Code's fullscreen layout is now on so the pane can sit on the right. Turning the side pane off switches it back.",
@@ -1033,7 +1062,32 @@
     "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"
+    "claude_pane_stopped": "stopped",
+    "claude_beginner_menu": "Beginner Mode",
+    "claude_beginner_tooltip": "Understand Claude’s answers: after each answer, see up to 3 technical terms explained above the prompt. Press 9 to mark them as understood so they stop appearing; a new conversation will later quiz you on them with a multiple-choice question. Uses a small amount of Claude quota.",
+    "claude_beginner_title": "Terms",
+    "claude_beginner_history_title": "Term history",
+    "claude_beginner_description": "Open your term history",
+    "claude_beginner_all_known": "All understood",
+    "claude_beginner_dismiss": "Dismiss",
+    "claude_beginner_known": "Understood",
+    "claude_beginner_unknown": "Not yet understood",
+    "claude_beginner_empty": "No terms yet.",
+    "claude_beginner_opened": "Term history opened.",
+    "claude_beginner_quiz_title": "Quick quiz",
+    "claude_beginner_quiz_question": "What does {term} mean?",
+    "claude_beginner_quiz_right": "Correct! Next quiz in {days} days.",
+    "claude_beginner_quiz_done": "Correct! You have learned this term.",
+    "claude_beginner_quiz_wrong": "Not quite. The answer is: {answer}. This term will show up in the hints again.",
+    "claude_beginner_enabled_msg": "Beginner Mode enabled. Restart Claude Code to apply.",
+    "claude_beginner_disabled_msg": "Beginner Mode disabled. Restart Claude Code to apply.",
+    "claude_beginner_action_failed": "Could not change Beginner Mode",
+    "quota_aware_menu": "Quota-Aware Mode",
+    "quota_aware_tooltip": "When quota is running low, Claude tells you how much remains and when it resets before starting a large task, so you can choose a smaller part now or wait for the reset.",
+    "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}"
   },
   "zh-CN": {
     "panel_default_name": "默认",
@@ -1526,6 +1580,8 @@
     "claude_pane_sidecar_error": "面板设置读取失败：{error}",
     "menu_badge_new": "新",
     "claude_pane_menu": "Claude Code 侧边面板",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "侧边面板",
     "claude_pane_tooltip": "在 Claude Code 显示额度、对话与后台任务",
     "claude_pane_enabled_msg": "已开启侧边面板。打开新的 Claude Code 对话（或在对话里输入 /reload-plugins）后生效；终端宽度不够时输入 /usage-dash 打开面板。",
     "claude_pane_fullscreen_enabled_note": "已一并开启 Claude Code 的全屏界面，让面板显示在右侧。取消勾选侧边面板时会改回。",
@@ -1551,7 +1607,32 @@
     "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": "已停止"
+    "claude_pane_stopped": "已停止",
+    "claude_beginner_menu": "新手模式",
+    "claude_beginner_tooltip": "帮你看懂 Claude 的回答：回答完，在输入框上方用白话提示最多 3 个专业术语。按 9 标成“懂了”就不再提示，之后开新对话时会出选择题小测验。会用到少量 Claude 额度。",
+    "claude_beginner_title": "术语提示",
+    "claude_beginner_history_title": "术语提示记录",
+    "claude_beginner_description": "打开术语提示记录",
+    "claude_beginner_all_known": "都懂了",
+    "claude_beginner_dismiss": "收起",
+    "claude_beginner_known": "懂了",
+    "claude_beginner_unknown": "还不懂",
+    "claude_beginner_empty": "还没有术语记录。",
+    "claude_beginner_opened": "已打开术语提示记录。",
+    "claude_beginner_quiz_title": "小测验",
+    "claude_beginner_quiz_question": "{term} 是什么意思？",
+    "claude_beginner_quiz_right": "答对了！{days} 天后再考一次。",
+    "claude_beginner_quiz_done": "答对了！这个词你已经学会了。",
+    "claude_beginner_quiz_wrong": "答错了。正确答案：{answer}。这个词之后会再出现在术语提示里。",
+    "claude_beginner_enabled_msg": "已开启新手模式。重启 Claude Code 后生效。",
+    "claude_beginner_disabled_msg": "已关闭新手模式。重启 Claude Code 后生效。",
+    "claude_beginner_action_failed": "无法切换新手模式",
+    "quota_aware_menu": "额度感知模式",
+    "quota_aware_tooltip": "额度快用完时，Claude 开大任务前会先告诉你还剩多少、几点重置，让你选先做小的还是等重置。",
+    "quota_aware_enabled_msg": "已开启额度感知模式。请重启 Claude Code 应用。",
+    "quota_aware_disabled_msg": "已关闭额度感知模式。请重启 Claude Code 应用。",
+    "quota_aware_action_failed": "无法切换额度感知模式。",
+    "claude_beginner_error": "新手模式：{error}"
   },
   "ja": {
     "panel_default_name": "デフォルト",
@@ -2044,6 +2125,8 @@
     "claude_pane_sidecar_error": "パネル設定を読み込めません: {error}",
     "menu_badge_new": "新規",
     "claude_pane_menu": "Claude Code サイドパネル",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "サイドペイン",
     "claude_pane_tooltip": "Claude Code に使用量、セッション、バックグラウンド作業を表示",
     "claude_pane_enabled_msg": "サイドパネルを有効にしました。新しい Claude Code セッションを開くか、会話で /reload-plugins を実行してください。ターミナルの幅が足りない場合は /usage-dash で開けます。",
     "claude_pane_fullscreen_enabled_note": "Claude Code のフルスクリーンレイアウトを有効にし、パネルを右側に表示できるようにしました。サイドパネルをオフにすると元に戻ります。",
@@ -2069,7 +2152,32 @@
     "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": "停止済み"
+    "claude_pane_stopped": "停止済み",
+    "claude_beginner_menu": "初心者モード",
+    "claude_beginner_tooltip": "Claude の回答をわかりやすく：回答後、入力欄の上に最大3つの専門用語をやさしく説明します。9を押すと「理解した」と記録して表示しなくなり、後日、新しい会話で選択式のミニテストが出ます。Claude の使用枠を少量使います。",
+    "claude_beginner_title": "用語のヒント",
+    "claude_beginner_history_title": "用語の履歴",
+    "claude_beginner_description": "用語の履歴を開く",
+    "claude_beginner_all_known": "すべて理解した",
+    "claude_beginner_dismiss": "閉じる",
+    "claude_beginner_known": "理解した",
+    "claude_beginner_unknown": "まだわからない",
+    "claude_beginner_empty": "用語の記録はまだありません。",
+    "claude_beginner_opened": "用語の履歴を開きました。",
+    "claude_beginner_quiz_title": "ミニテスト",
+    "claude_beginner_quiz_question": "{term} の意味は？",
+    "claude_beginner_quiz_right": "正解！{days} 日後にもう一度出題します。",
+    "claude_beginner_quiz_done": "正解！この用語は覚えました。",
+    "claude_beginner_quiz_wrong": "不正解。正解は「{answer}」です。この用語はまた用語ヒントに表示されます。",
+    "claude_beginner_enabled_msg": "初心者モードを有効にしました。Claude Code を再起動してください。",
+    "claude_beginner_disabled_msg": "初心者モードを無効にしました。Claude Code を再起動してください。",
+    "claude_beginner_action_failed": "初心者モードを切り替えられません",
+    "quota_aware_menu": "クォータ認識モード",
+    "quota_aware_tooltip": "クォータが少なくなると、大きなタスクを始める前に Claude が残量とリセット時刻を伝えます。小さな部分を先に進めるか、リセットを待つか選べます。",
+    "quota_aware_enabled_msg": "クォータ認識モードを有効にしました。Claude Code を再起動してください。",
+    "quota_aware_disabled_msg": "クォータ認識モードを無効にしました。Claude Code を再起動してください。",
+    "quota_aware_action_failed": "クォータ認識モードを切り替えられませんでした。",
+    "claude_beginner_error": "初心者モード：{error}"
   },
   "ko": {
     "panel_default_name": "기본",
@@ -2562,6 +2670,8 @@
     "claude_pane_sidecar_error": "패널 설정을 읽을 수 없습니다: {error}",
     "menu_badge_new": "신규",
     "claude_pane_menu": "Claude Code 사이드 패널",
+    "claude_code_section": "Claude Code",
+    "claude_pane_section_menu": "사이드 패널",
     "claude_pane_tooltip": "Claude Code에 사용량, 대화 및 백그라운드 작업 표시",
     "claude_pane_enabled_msg": "사이드 패널을 켰습니다. 새 Claude Code 대화를 열거나 대화에서 /reload-plugins를 실행하세요. 터미널이 좁으면 /usage-dash로 패널을 여세요.",
     "claude_pane_fullscreen_enabled_note": "Claude Code의 전체 화면 레이아웃도 켜서 패널이 오른쪽에 표시됩니다. 사이드 패널을 끄면 원래대로 돌아갑니다.",
@@ -2587,6 +2697,31 @@
     "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": "중지됨"
+    "claude_pane_stopped": "중지됨",
+    "claude_beginner_menu": "초보자 모드",
+    "claude_beginner_tooltip": "Claude의 답변을 쉽게 이해하세요. 답변 후 입력창 위에 전문 용어를 최대 3개까지 쉽게 설명합니다. 9를 누르면 이해한 것으로 기록하여 더 이상 표시하지 않고, 나중에 새 대화에서 객관식 퀴즈를 냅니다. Claude 사용량을 조금 씁니다.",
+    "claude_beginner_title": "용어 안내",
+    "claude_beginner_history_title": "용어 안내 기록",
+    "claude_beginner_description": "용어 안내 기록 열기",
+    "claude_beginner_all_known": "모두 이해했어요",
+    "claude_beginner_dismiss": "닫기",
+    "claude_beginner_known": "이해했어요",
+    "claude_beginner_unknown": "아직 모르겠어요",
+    "claude_beginner_empty": "아직 용어 기록이 없습니다.",
+    "claude_beginner_opened": "용어 안내 기록을 열었습니다.",
+    "claude_beginner_quiz_title": "퀴즈",
+    "claude_beginner_quiz_question": "{term}의 뜻은?",
+    "claude_beginner_quiz_right": "정답! {days}일 후에 다시 출제합니다.",
+    "claude_beginner_quiz_done": "정답! 이 용어를 익혔어요.",
+    "claude_beginner_quiz_wrong": "오답이에요. 정답: {answer}. 이 용어는 용어 힌트에 다시 나타납니다.",
+    "claude_beginner_enabled_msg": "초보자 모드를 켰습니다. Claude Code를 다시 시작하세요.",
+    "claude_beginner_disabled_msg": "초보자 모드를 껐습니다. Claude Code를 다시 시작하세요.",
+    "claude_beginner_action_failed": "초보자 모드를 전환할 수 없습니다",
+    "quota_aware_menu": "할당량 인식 모드",
+    "quota_aware_tooltip": "할당량이 부족해지면 Claude가 큰 작업을 시작하기 전에 남은 양과 초기화 시간을 알려 줍니다. 작은 부분을 먼저 진행하거나 초기화를 기다릴 수 있습니다.",
+    "quota_aware_enabled_msg": "할당량 인식 모드를 켰습니다. Claude Code를 다시 시작해 주세요.",
+    "quota_aware_disabled_msg": "할당량 인식 모드를 껐습니다. Claude Code를 다시 시작해 주세요.",
+    "quota_aware_action_failed": "할당량 인식 모드를 변경할 수 없습니다.",
+    "claude_beginner_error": "초보자 모드: {error}"
   }
 }

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

@@ -33,10 +33,18 @@ def _remove_path(value: str, path: str) -> str:
     return os.pathsep.join(parts) if any(parts) else ""
 
 
-def _resolve_source() -> Path:
+def _install_dir(mod: str) -> Path:
+    return INSTALL_DIR.with_name("usage-beginner") if mod == "usage-beginner" else INSTALL_DIR
+
+
+def _sidecar_name(mod: str) -> str:
+    return "usage-beginner.json" if mod == "usage-beginner" else "usage-pane.json"
+
+
+def _resolve_source(mod: str = "usage-dash") -> Path:
     paths = [
-        Path(__file__).resolve().parent.parent / "claude_pane" / "usage-dash",
-        Path(sys.executable).resolve().parent.parent / "Resources" / "claude_pane" / "usage-dash",
+        Path(__file__).resolve().parent.parent / "claude_pane" / mod,
+        Path(sys.executable).resolve().parent.parent / "Resources" / "claude_pane" / mod,
     ]
     for path in paths:
         if path.is_dir():
@@ -72,7 +80,7 @@ def _status_argv() -> list[str]:
     ]
 
 
-def _sidecar_text() -> str:
+def _sidecar_text(mod: str = "usage-dash") -> str:
     from i18n import I18N_PATH
 
     bundle = json.loads(I18N_PATH.read_text(encoding="utf-8"))
@@ -81,30 +89,36 @@ def _sidecar_text() -> str:
     strings = {
         key: table.get(key) or value
         for key, value in english.items()
-        if key.startswith("claude_pane_")
+        if key.startswith("claude_beginner_" if mod == "usage-beginner" else "claude_pane_")
     }
     return (
         json.dumps(
-            {"strings": strings, "status_argv": _status_argv()}, ensure_ascii=False, indent=2
+            (
+                {"strings": strings, "lang": detect_lang()}
+                if mod == "usage-beginner"
+                else {"strings": strings, "status_argv": _status_argv()}
+            ),
+            ensure_ascii=False,
+            indent=2,
         )
         + "\n"
     )
 
 
-def _write_sidecar() -> None:
-    setup_hook._atomic_write_text(INSTALL_DIR / "usage-pane.json", _sidecar_text())
+def _write_sidecar(mod: str = "usage-dash") -> None:
+    setup_hook._atomic_write_text(_install_dir(mod) / _sidecar_name(mod), _sidecar_text(mod))
 
 
-def _copy_pane() -> None:
-    source = _resolve_source()
-    if INSTALL_DIR.exists():
-        shutil.rmtree(INSTALL_DIR)
-    shutil.copytree(source, INSTALL_DIR, ignore=shutil.ignore_patterns("*.test.ts"))
-    _write_sidecar()
+def _copy_pane(mod: str = "usage-dash") -> None:
+    source = _resolve_source(mod)
+    if _install_dir(mod).exists():
+        shutil.rmtree(_install_dir(mod))
+    shutil.copytree(source, _install_dir(mod), ignore=shutil.ignore_patterns("*.test.ts"))
+    _write_sidecar() if mod == "usage-dash" else _write_sidecar(mod)
 
 
-def _installed_is_current() -> bool:
-    source = _resolve_source()
+def _installed_is_current(mod: str = "usage-dash") -> bool:
+    source = _resolve_source(mod)
     shipped = {
         path.relative_to(source)
         for path in source.rglob("*")
@@ -113,16 +127,20 @@ def _installed_is_current() -> bool:
     # Claude Code writes its own type stubs under .claude-plugin/types; they are not ours.
     generated = Path(".claude-plugin", "types")
     installed = {
-        path.relative_to(INSTALL_DIR)
-        for path in INSTALL_DIR.rglob("*")
-        if path.is_file() and generated not in path.relative_to(INSTALL_DIR).parents
-    } - {Path("usage-pane.json")}
+        path.relative_to(_install_dir(mod))
+        for path in _install_dir(mod).rglob("*")
+        if path.is_file() and generated not in path.relative_to(_install_dir(mod)).parents
+    } - {Path(_sidecar_name(mod))}
     if shipped != installed:
         return False
-    if not all(filecmp.cmp(source / path, INSTALL_DIR / path, shallow=False) for path in shipped):
+    if not all(
+        filecmp.cmp(source / path, _install_dir(mod) / path, shallow=False) for path in shipped
+    ):
         return False
     try:
-        return (INSTALL_DIR / "usage-pane.json").read_text(encoding="utf-8") == _sidecar_text()
+        return (_install_dir(mod) / _sidecar_name(mod)).read_text(
+            encoding="utf-8"
+        ) == _sidecar_text(mod)
     except OSError:
         return False
 
@@ -134,11 +152,13 @@ def _env(settings: dict[str, object]) -> dict[str, str]:
     return env
 
 
-def enable_claude_pane() -> int:
-    _copy_pane()
+def enable_claude_pane(mod: str = "usage-dash") -> int:
+    _copy_pane() if mod == "usage-dash" else _copy_pane(mod)
     settings = setup_hook._load_settings()
     env = _env(settings)
-    env[PLUGIN_DIRS_KEY] = _add_path(env.get(PLUGIN_DIRS_KEY, ""), str(INSTALL_DIR.absolute()))
+    env[PLUGIN_DIRS_KEY] = _add_path(
+        env.get(PLUGIN_DIRS_KEY, ""), str(_install_dir(mod).absolute())
+    )
     settings["env"] = env
     setup_hook._save_settings(settings)
     return 0
@@ -159,12 +179,12 @@ def enable_fullscreen_layout() -> None:
     setup_hook._save_settings(settings)
 
 
-def disable_claude_pane() -> int:
+def disable_claude_pane(mod: str = "usage-dash") -> int:
     settings = setup_hook._load_settings()
     env = _env(settings)
     changed = False
     if PLUGIN_DIRS_KEY in env:
-        value = _remove_path(env[PLUGIN_DIRS_KEY], str(INSTALL_DIR.absolute()))
+        value = _remove_path(env[PLUGIN_DIRS_KEY], str(_install_dir(mod).absolute()))
         if value:
             env[PLUGIN_DIRS_KEY] = value
         else:
@@ -173,7 +193,11 @@ def disable_claude_pane() -> int:
             settings.pop("env", None)
         changed = True
     usage = settings.get("usage")
-    if isinstance(usage, dict) and usage.get("claudePaneSetFullscreen") is True:
+    if (
+        mod == "usage-dash"
+        and isinstance(usage, dict)
+        and usage.get("claudePaneSetFullscreen") is True
+    ):
         if settings.get("tui") == "fullscreen":
             settings.pop("tui")
         usage.pop("claudePaneSetFullscreen")
@@ -182,18 +206,19 @@ def disable_claude_pane() -> int:
         changed = True
     if changed:
         setup_hook._save_settings(settings)
-    if INSTALL_DIR.exists():
-        shutil.rmtree(INSTALL_DIR)
+    if _install_dir(mod).exists():
+        shutil.rmtree(_install_dir(mod))
     return 0
 
 
-def is_claude_pane_enabled() -> bool:
+def is_claude_pane_enabled(mod: str = "usage-dash") -> bool:
     try:
         value = _env(setup_hook._load_settings()).get(PLUGIN_DIRS_KEY, "")
     except SystemExit:
         return False
-    return INSTALL_DIR.is_dir() and any(
-        part and _same_path(part, str(INSTALL_DIR.absolute())) for part in value.split(os.pathsep)
+    return _install_dir(mod).is_dir() and any(
+        part and _same_path(part, str(_install_dir(mod).absolute()))
+        for part in value.split(os.pathsep)
     )
 
 
@@ -201,3 +226,17 @@ def refresh_claude_pane() -> None:
     """Re-copy an enabled pane whose files differ from this build's, e.g. after an app upgrade."""
     if is_claude_pane_enabled() and not _installed_is_current():
         _copy_pane()
+    if is_claude_beginner_enabled() and not _installed_is_current("usage-beginner"):
+        _copy_pane("usage-beginner")
+
+
+def enable_claude_beginner() -> int:
+    return enable_claude_pane("usage-beginner")
+
+
+def disable_claude_beginner() -> int:
+    return disable_claude_pane("usage-beginner")
+
+
+def is_claude_beginner_enabled() -> bool:
+    return is_claude_pane_enabled("usage-beginner")

{usage_cli-0.32.6 → usage_cli-0.33.0}/installer/session_hooks.py

@@ -92,6 +92,12 @@ TERSE_REMINDER_HOOK_VERSION = "1.2"
 TERSE_REMINDER_MATCHER = ""
 _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.0"
+QUOTA_AWARE_MATCHER = ""
+_QUOTA_AWARE_MARKER = "usage-quota-aware"
+_QUOTA_AWARE_MARKERS = (_QUOTA_AWARE_MARKER, "usage_quota_aware")
 
 
 def _migrate_bundled_python_commands_if_needed(
@@ -1252,9 +1258,119 @@ def self_heal() -> None:
             raise
         _debug_self_heal_failure("resume_hook", exc)
 
+    try:
+        _self_heal_quota_aware()
+    except BaseException as exc:
+        if isinstance(exc, KeyboardInterrupt):
+            raise
+        _debug_self_heal_failure("quota_aware_hook", exc)
+
     try:
         _self_heal_terse_mode()
     except BaseException as exc:
         if isinstance(exc, KeyboardInterrupt):
             raise
         _debug_self_heal_failure("terse_hook", exc)
+
+
+def _resolve_quota_aware_source() -> Path:
+    paths = [
+        Path(__file__).resolve().parent.parent / "usage_quota_aware.py",
+        Path(sys.executable).resolve().parent.parent / "Resources" / "usage_quota_aware.py",
+    ]
+    for path in paths:
+        if path.exists():
+            return path
+    raise SystemExit(_t("setup_hook_source_missing", tried=", ".join(map(str, paths))))
+
+
+def _quota_aware_command() -> str:
+    return f"{_shell_arg(_find_system_python())} {_shell_arg(str(QUOTA_AWARE_HOOK_TARGET))}"
+
+
+def _copy_quota_aware_script() -> None:
+    QUOTA_AWARE_HOOK_TARGET.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copyfile(_resolve_quota_aware_source(), QUOTA_AWARE_HOOK_TARGET)
+    QUOTA_AWARE_HOOK_TARGET.chmod(
+        QUOTA_AWARE_HOOK_TARGET.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH
+    )
+
+
+def is_quota_aware_enabled() -> bool:
+    try:
+        entries = _user_prompt_submit_list(_load_settings())
+    except SystemExit:
+        return False
+    return any(_is_hook_entry(entry, _QUOTA_AWARE_MARKERS) for entry in entries or [])
+
+
+def enable_quota_aware() -> int:
+    if not setup_hook._claude_settings_dir_exists():
+        print(_t("setup_no_agents"), file=sys.stderr)
+        return 1
+    _copy_quota_aware_script()
+    settings = _load_settings()
+    hooks = settings.get("hooks")
+    if not isinstance(hooks, dict):
+        hooks = {}
+        settings["hooks"] = hooks
+    entries = _user_prompt_submit_list(settings) or []
+    hooks["UserPromptSubmit"] = [
+        kept
+        for entry in entries
+        if (kept := _strip_hook_entries(entry, _QUOTA_AWARE_MARKERS)) is not None
+    ] + [
+        {
+            "matcher": QUOTA_AWARE_MATCHER,
+            "hooks": [{"type": "command", "command": _quota_aware_command()}],
+        }
+    ]
+    _save_settings(settings)
+    print(_t("quota_aware_enabled_msg"))
+    print(_t("setup_claude_restart_required"))
+    return 0
+
+
+def disable_quota_aware() -> int:
+    settings = _load_settings()
+    entries = _user_prompt_submit_list(settings)
+    if entries is not None:
+        kept = [
+            item
+            for entry in entries
+            if (item := _strip_hook_entries(entry, _QUOTA_AWARE_MARKERS)) is not None
+        ]
+        if kept != entries:
+            hooks = settings["hooks"]
+            if kept:
+                hooks["UserPromptSubmit"] = kept
+            else:
+                hooks.pop("UserPromptSubmit", None)
+            if not hooks:
+                settings.pop("hooks", None)
+            _save_settings(settings)
+    if QUOTA_AWARE_HOOK_TARGET.exists():
+        QUOTA_AWARE_HOOK_TARGET.unlink()
+    print(_t("quota_aware_disabled_msg"))
+    return 0
+
+
+def _installed_quota_aware_version() -> str | None:
+    try:
+        for line in QUOTA_AWARE_HOOK_TARGET.read_text(encoding="utf-8").splitlines():
+            if line.startswith("__version__"):
+                return line.partition("=")[2].strip().strip("\"'")
+    except (OSError, UnicodeError):
+        pass
+    return None
+
+
+def _self_heal_quota_aware() -> None:
+    if not is_quota_aware_enabled():
+        return
+    old = _installed_quota_aware_version()
+    if old != QUOTA_AWARE_HOOK_VERSION:
+        _copy_quota_aware_script()
+        _append_self_heal_log(
+            "update_quota_aware_hook", f"{old or 'unknown'} -> {QUOTA_AWARE_HOOK_VERSION}"
+        )