usage-cli 0.31.5__tar.gz → 0.32.0__tar.gz

{usage_cli-0.31.5/usage_cli.egg-info → usage_cli-0.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.31.5
+Version: 0.32.0
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -76,8 +76,9 @@ 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):** Toggle quotas, Claude sessions and background jobs inside Claude Code. Requires a recent Claude Code with mod support (tested with 2.1.289). Open a new conversation or run `/reload-plugins` after enabling. The pane opens on the right automatically at terminal widths ≥144 columns; use `/usage-dash` in narrower terminals. macOS Terminal supports only 256 colors and may show a gray background; select an ANSI dark theme in `/config`. Conversations waiting for your permission or MCP input are marked in yellow across panes, and background jobs also list subagents started by Claude with the Agent tool and their status. When the usage app starts, it automatically updates an enabled pane to the bundled version.
 - **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 and Codex 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).
+- **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

{usage_cli-0.31.5 → usage_cli-0.32.0}/README.md

@@ -56,8 +56,9 @@ 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):** Toggle quotas, Claude sessions and background jobs inside Claude Code. Requires a recent Claude Code with mod support (tested with 2.1.289). Open a new conversation or run `/reload-plugins` after enabling. The pane opens on the right automatically at terminal widths ≥144 columns; use `/usage-dash` in narrower terminals. macOS Terminal supports only 256 colors and may show a gray background; select an ANSI dark theme in `/config`. Conversations waiting for your permission or MCP input are marked in yellow across panes, and background jobs also list subagents started by Claude with the Agent tool and their status. When the usage app starts, it automatically updates an enabled pane to the bundled version.
 - **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 and Codex 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).
+- **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

{usage_cli-0.31.5 → usage_cli-0.32.0}/i18n.json

@@ -425,7 +425,60 @@
     "setup_hook_deleted": "✓ 已刪除 hook：{path}",
     "setup_status_file_deleted": "✓ 已刪除狀態檔：{path}",
     "wintray_unavailable": "Windows 系統匣介面尚未安裝，改用終端機 TUI。",
-    "wintray_already_running": "usage 已在執行中；請點系統匣的 usage 圖示開啟面板。"
+    "wintray_already_running": "usage 已在執行中；請點系統匣的 usage 圖示開啟面板。",
+    "claude_pane_quota": "額度",
+    "claude_pane_five_hour": "5小時",
+    "claude_pane_week": "週",
+    "claude_pane_period": "期間",
+    "claude_pane_sessions": "Claude 對話",
+    "claude_pane_busy": "忙",
+    "claude_pane_waiting": "等你",
+    "claude_pane_agent_running": "執行中",
+    "claude_pane_agent_idle": "閒置",
+    "claude_pane_agent_pending": "待執行",
+    "claude_pane_busy_count": "{count} 忙 / {total}",
+    "claude_pane_idle": "閒置 {ago}",
+    "claude_pane_runs": "背景工作",
+    "claude_pane_none": "（沒有）",
+    "claude_pane_untitled": "（無標題）",
+    "claude_pane_no_project": "（無專案）",
+    "claude_pane_here": "（這裡）",
+    "claude_pane_more": "還有 {count} 個",
+    "claude_pane_less": "收回",
+    "claude_pane_terminal": "終端",
+    "claude_pane_desktop": "桌面",
+    "claude_pane_minutes": "{count}分",
+    "claude_pane_hours": "{count}時",
+    "claude_pane_days": "{count}天",
+    "claude_pane_seconds": "{count}秒",
+    "claude_pane_minutes_ago": "{count}分前",
+    "claude_pane_seconds_ago": "{count}秒前",
+    "claude_pane_just_now": "剛剛",
+    "claude_pane_failed": "失敗",
+    "claude_pane_completed": "完成",
+    "claude_pane_completed_ago": "{ago}{status}",
+    "claude_pane_quota_invalid": "額度 JSON 缺少 agents",
+    "claude_pane_exit_code": "結束碼 {code}",
+    "claude_pane_quota_error": "額度讀取失敗：{error}",
+    "claude_pane_session_error": "對話讀取失敗：{error}",
+    "claude_pane_home_missing": "HOME 未設定",
+    "claude_pane_description": "開啟額度、Claude 對話與背景工作面板",
+    "claude_pane_title": "使用狀態",
+    "claude_pane_opened": "已開啟使用狀態面板。",
+    "claude_pane_compact_summary": "對話 {busy} 忙 / {total} · 背景工作 ",
+    "claude_pane_sidecar_error": "面板設定讀取失敗：{error}",
+    "menu_badge_new": "新",
+    "claude_pane_menu": "Claude Code 側邊面板",
+    "claude_pane_tooltip": "在 Claude Code 顯示額度、對話與背景工作",
+    "claude_pane_enabled_msg": "已開啟側邊面板。開新的 Claude Code 對話（或在對話裡打 /reload-plugins）後生效；終端機寬度不夠時打 /usage-dash 叫出面板。",
+    "claude_pane_disabled_msg": "已移除 Claude Code 側邊面板。",
+    "claude_pane_action_failed": "Claude Code 側邊面板切換失敗。",
+    "claude_pane_source_missing": "找不到面板原始碼。已檢查：{tried}",
+    "claude_pane_invalid_env": "Claude 設定的 env 必須是物件，CLAUDE_CODE_PLUGIN_DIRS 必須是字串。",
+    "claude_pane_invalid_sidecar": "usage-pane.json 格式錯誤",
+    "claude_pane_elapsed": "{minutes}分{seconds}秒",
+    "claude_pane_remaining": "剩",
+    "claude_pane_hours_ago": "{count}時前"
   },
   "en": {
     "panel_default_name": "Default",
@@ -853,7 +906,60 @@
     "setup_hook_deleted": "✓ Deleted hook: {path}",
     "setup_status_file_deleted": "✓ Deleted status file: {path}",
     "wintray_unavailable": "The Windows tray interface is not installed; falling back to the terminal TUI.",
-    "wintray_already_running": "usage is already running; click the usage tray icon to open the panel."
+    "wintray_already_running": "usage is already running; click the usage tray icon to open the panel.",
+    "claude_pane_quota": "Quota",
+    "claude_pane_five_hour": "5h",
+    "claude_pane_week": "Week",
+    "claude_pane_period": "Period",
+    "claude_pane_sessions": "Claude sessions",
+    "claude_pane_busy": "Busy",
+    "claude_pane_waiting": "waiting for you",
+    "claude_pane_agent_running": "running",
+    "claude_pane_agent_idle": "idle",
+    "claude_pane_agent_pending": "pending",
+    "claude_pane_busy_count": "{count} busy / {total}",
+    "claude_pane_idle": "Idle {ago}",
+    "claude_pane_runs": "Background jobs",
+    "claude_pane_none": "(none)",
+    "claude_pane_untitled": "(untitled)",
+    "claude_pane_no_project": "(no project)",
+    "claude_pane_here": "(here)",
+    "claude_pane_more": "{count} more",
+    "claude_pane_less": "Show less",
+    "claude_pane_terminal": "Terminal",
+    "claude_pane_desktop": "Desktop",
+    "claude_pane_minutes": "{count}m",
+    "claude_pane_hours": "{count}h",
+    "claude_pane_days": "{count}d",
+    "claude_pane_seconds": "{count}s",
+    "claude_pane_minutes_ago": "{count}m ago",
+    "claude_pane_seconds_ago": "{count}s ago",
+    "claude_pane_just_now": "just now",
+    "claude_pane_failed": "failed",
+    "claude_pane_completed": "completed",
+    "claude_pane_completed_ago": "{ago} · {status}",
+    "claude_pane_quota_invalid": "Quota JSON has no agents",
+    "claude_pane_exit_code": "exit code {code}",
+    "claude_pane_quota_error": "Cannot read quota: {error}",
+    "claude_pane_session_error": "Cannot read sessions: {error}",
+    "claude_pane_home_missing": "HOME is not set",
+    "claude_pane_description": "Open the quota, Claude sessions and background jobs pane",
+    "claude_pane_title": "Usage",
+    "claude_pane_opened": "Usage pane opened.",
+    "claude_pane_compact_summary": "Sessions {busy} busy / {total} · Background jobs ",
+    "claude_pane_sidecar_error": "Cannot read pane settings: {error}",
+    "menu_badge_new": "New",
+    "claude_pane_menu": "Claude Code 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_disabled_msg": "Claude Code side pane removed.",
+    "claude_pane_action_failed": "Could not change the Claude Code side pane.",
+    "claude_pane_source_missing": "Pane source not found. Tried: {tried}",
+    "claude_pane_invalid_env": "Claude settings env must be an object and CLAUDE_CODE_PLUGIN_DIRS must be a string.",
+    "claude_pane_invalid_sidecar": "Invalid usage-pane.json",
+    "claude_pane_elapsed": "{minutes}m{seconds}s",
+    "claude_pane_remaining": "left",
+    "claude_pane_hours_ago": "{count}h ago"
   },
   "zh-CN": {
     "panel_default_name": "默认",
@@ -1281,7 +1387,60 @@
     "setup_hook_deleted": "✓ 已删除 hook：{path}",
     "setup_status_file_deleted": "✓ 已删除状态文件：{path}",
     "wintray_unavailable": "Windows 系统托盘界面尚未安装，改用终端 TUI。",
-    "wintray_already_running": "usage 已在运行；请点击系统托盘的 usage 图标打开面板。"
+    "wintray_already_running": "usage 已在运行；请点击系统托盘的 usage 图标打开面板。",
+    "claude_pane_quota": "额度",
+    "claude_pane_five_hour": "5小时",
+    "claude_pane_week": "周",
+    "claude_pane_period": "期间",
+    "claude_pane_sessions": "Claude 对话",
+    "claude_pane_busy": "忙",
+    "claude_pane_waiting": "等你",
+    "claude_pane_agent_running": "运行中",
+    "claude_pane_agent_idle": "空闲",
+    "claude_pane_agent_pending": "待运行",
+    "claude_pane_busy_count": "{count} 忙 / {total}",
+    "claude_pane_idle": "闲置 {ago}",
+    "claude_pane_runs": "后台任务",
+    "claude_pane_none": "（没有）",
+    "claude_pane_untitled": "（无标题）",
+    "claude_pane_no_project": "（无项目）",
+    "claude_pane_here": "（这里）",
+    "claude_pane_more": "还有 {count} 个",
+    "claude_pane_less": "收起",
+    "claude_pane_terminal": "终端",
+    "claude_pane_desktop": "桌面",
+    "claude_pane_minutes": "{count}分",
+    "claude_pane_hours": "{count}时",
+    "claude_pane_days": "{count}天",
+    "claude_pane_seconds": "{count}秒",
+    "claude_pane_minutes_ago": "{count}分前",
+    "claude_pane_seconds_ago": "{count}秒前",
+    "claude_pane_just_now": "刚刚",
+    "claude_pane_failed": "失败",
+    "claude_pane_completed": "完成",
+    "claude_pane_completed_ago": "{ago}{status}",
+    "claude_pane_quota_invalid": "额度 JSON 缺少 agents",
+    "claude_pane_exit_code": "退出码 {code}",
+    "claude_pane_quota_error": "额度读取失败：{error}",
+    "claude_pane_session_error": "对话读取失败：{error}",
+    "claude_pane_home_missing": "HOME 未设置",
+    "claude_pane_description": "打开额度、Claude 对话与后台任务面板",
+    "claude_pane_title": "使用状态",
+    "claude_pane_opened": "已打开使用状态面板。",
+    "claude_pane_compact_summary": "对话 {busy} 忙 / {total} · 后台任务 ",
+    "claude_pane_sidecar_error": "面板设置读取失败：{error}",
+    "menu_badge_new": "新",
+    "claude_pane_menu": "Claude Code 侧边面板",
+    "claude_pane_tooltip": "在 Claude Code 显示额度、对话与后台任务",
+    "claude_pane_enabled_msg": "已开启侧边面板。打开新的 Claude Code 对话（或在对话里输入 /reload-plugins）后生效；终端宽度不够时输入 /usage-dash 打开面板。",
+    "claude_pane_disabled_msg": "已移除 Claude Code 侧边面板。",
+    "claude_pane_action_failed": "Claude Code 侧边面板切换失败。",
+    "claude_pane_source_missing": "找不到面板源代码。已检查：{tried}",
+    "claude_pane_invalid_env": "Claude 设置的 env 必须是对象，CLAUDE_CODE_PLUGIN_DIRS 必须是字符串。",
+    "claude_pane_invalid_sidecar": "usage-pane.json 格式错误",
+    "claude_pane_elapsed": "{minutes}分{seconds}秒",
+    "claude_pane_remaining": "剩",
+    "claude_pane_hours_ago": "{count}时前"
   },
   "ja": {
     "panel_default_name": "デフォルト",
@@ -1709,7 +1868,60 @@
     "setup_hook_deleted": "✓ hook を削除しました: {path}",
     "setup_status_file_deleted": "✓ 状態ファイルを削除しました: {path}",
     "wintray_unavailable": "Windows のシステムトレイ画面は未インストールです。ターミナル TUI に切り替えます。",
-    "wintray_already_running": "usage は既に実行中です。トレイの usage アイコンをクリックしてパネルを開いてください。"
+    "wintray_already_running": "usage は既に実行中です。トレイの usage アイコンをクリックしてパネルを開いてください。",
+    "claude_pane_quota": "使用量",
+    "claude_pane_five_hour": "5時間",
+    "claude_pane_week": "週",
+    "claude_pane_period": "期間",
+    "claude_pane_sessions": "Claude セッション",
+    "claude_pane_busy": "実行中",
+    "claude_pane_waiting": "入力待ち",
+    "claude_pane_agent_running": "実行中",
+    "claude_pane_agent_idle": "待機中",
+    "claude_pane_agent_pending": "実行待ち",
+    "claude_pane_busy_count": "{count} 実行中 / {total}",
+    "claude_pane_idle": "待機 {ago}",
+    "claude_pane_runs": "バックグラウンド作業",
+    "claude_pane_none": "（なし）",
+    "claude_pane_untitled": "（無題）",
+    "claude_pane_no_project": "（プロジェクトなし）",
+    "claude_pane_here": "（ここ）",
+    "claude_pane_more": "あと {count} 件",
+    "claude_pane_less": "折りたたむ",
+    "claude_pane_terminal": "ターミナル",
+    "claude_pane_desktop": "デスクトップ",
+    "claude_pane_minutes": "{count}分",
+    "claude_pane_hours": "{count}時間",
+    "claude_pane_days": "{count}日",
+    "claude_pane_seconds": "{count}秒",
+    "claude_pane_minutes_ago": "{count}分前",
+    "claude_pane_seconds_ago": "{count}秒前",
+    "claude_pane_just_now": "たった今",
+    "claude_pane_failed": "失敗",
+    "claude_pane_completed": "完了",
+    "claude_pane_completed_ago": "{ago} · {status}",
+    "claude_pane_quota_invalid": "使用量 JSON に agents がありません",
+    "claude_pane_exit_code": "終了コード {code}",
+    "claude_pane_quota_error": "使用量を読み込めません: {error}",
+    "claude_pane_session_error": "セッションを読み込めません: {error}",
+    "claude_pane_home_missing": "HOME が設定されていません",
+    "claude_pane_description": "使用量、Claude セッション、バックグラウンド作業のパネルを開く",
+    "claude_pane_title": "使用状況",
+    "claude_pane_opened": "使用状況パネルを開きました。",
+    "claude_pane_compact_summary": "セッション {busy} 実行中 / {total} · バックグラウンド作業 ",
+    "claude_pane_sidecar_error": "パネル設定を読み込めません: {error}",
+    "menu_badge_new": "新規",
+    "claude_pane_menu": "Claude Code サイドパネル",
+    "claude_pane_tooltip": "Claude Code に使用量、セッション、バックグラウンド作業を表示",
+    "claude_pane_enabled_msg": "サイドパネルを有効にしました。新しい Claude Code セッションを開くか、会話で /reload-plugins を実行してください。ターミナルの幅が足りない場合は /usage-dash で開けます。",
+    "claude_pane_disabled_msg": "Claude Code サイドパネルを削除しました。",
+    "claude_pane_action_failed": "Claude Code サイドパネルを切り替えられませんでした。",
+    "claude_pane_source_missing": "パネルのソースがありません。確認先: {tried}",
+    "claude_pane_invalid_env": "Claude 設定の env はオブジェクト、CLAUDE_CODE_PLUGIN_DIRS は文字列が必要です。",
+    "claude_pane_invalid_sidecar": "usage-pane.json の形式が不正です",
+    "claude_pane_elapsed": "{minutes}分{seconds}秒",
+    "claude_pane_remaining": "残り",
+    "claude_pane_hours_ago": "{count}時間前"
   },
   "ko": {
     "panel_default_name": "기본",
@@ -2137,6 +2349,59 @@
     "setup_hook_deleted": "✓ hook 삭제됨: {path}",
     "setup_status_file_deleted": "✓ 상태 파일 삭제됨: {path}",
     "wintray_unavailable": "Windows 시스템 트레이 화면이 설치되지 않아 터미널 TUI로 전환합니다.",
-    "wintray_already_running": "usage가 이미 실행 중입니다. 트레이의 usage 아이콘을 클릭해 패널을 여세요."
+    "wintray_already_running": "usage가 이미 실행 중입니다. 트레이의 usage 아이콘을 클릭해 패널을 여세요.",
+    "claude_pane_quota": "사용량",
+    "claude_pane_five_hour": "5시간",
+    "claude_pane_week": "주간",
+    "claude_pane_period": "기간",
+    "claude_pane_sessions": "Claude 대화",
+    "claude_pane_busy": "작업 중",
+    "claude_pane_waiting": "입력 대기",
+    "claude_pane_agent_running": "실행 중",
+    "claude_pane_agent_idle": "유휴",
+    "claude_pane_agent_pending": "실행 대기",
+    "claude_pane_busy_count": "{count} 작업 중 / {total}",
+    "claude_pane_idle": "대기 {ago}",
+    "claude_pane_runs": "백그라운드 작업",
+    "claude_pane_none": "(없음)",
+    "claude_pane_untitled": "(제목 없음)",
+    "claude_pane_no_project": "(프로젝트 없음)",
+    "claude_pane_here": "(여기)",
+    "claude_pane_more": "{count}개 더",
+    "claude_pane_less": "접기",
+    "claude_pane_terminal": "터미널",
+    "claude_pane_desktop": "데스크톱",
+    "claude_pane_minutes": "{count}분",
+    "claude_pane_hours": "{count}시간",
+    "claude_pane_days": "{count}일",
+    "claude_pane_seconds": "{count}초",
+    "claude_pane_minutes_ago": "{count}분 전",
+    "claude_pane_seconds_ago": "{count}초 전",
+    "claude_pane_just_now": "방금",
+    "claude_pane_failed": "실패",
+    "claude_pane_completed": "완료",
+    "claude_pane_completed_ago": "{ago} · {status}",
+    "claude_pane_quota_invalid": "사용량 JSON에 agents가 없습니다",
+    "claude_pane_exit_code": "종료 코드 {code}",
+    "claude_pane_quota_error": "사용량을 읽을 수 없습니다: {error}",
+    "claude_pane_session_error": "대화를 읽을 수 없습니다: {error}",
+    "claude_pane_home_missing": "HOME이 설정되지 않았습니다",
+    "claude_pane_description": "사용량, Claude 대화 및 백그라운드 작업 패널 열기",
+    "claude_pane_title": "사용 현황",
+    "claude_pane_opened": "사용 현황 패널을 열었습니다.",
+    "claude_pane_compact_summary": "대화 {busy} 작업 중 / {total} · 백그라운드 작업 ",
+    "claude_pane_sidecar_error": "패널 설정을 읽을 수 없습니다: {error}",
+    "menu_badge_new": "신규",
+    "claude_pane_menu": "Claude Code 사이드 패널",
+    "claude_pane_tooltip": "Claude Code에 사용량, 대화 및 백그라운드 작업 표시",
+    "claude_pane_enabled_msg": "사이드 패널을 켰습니다. 새 Claude Code 대화를 열거나 대화에서 /reload-plugins를 실행하세요. 터미널이 좁으면 /usage-dash로 패널을 여세요.",
+    "claude_pane_disabled_msg": "Claude Code 사이드 패널을 제거했습니다.",
+    "claude_pane_action_failed": "Claude Code 사이드 패널을 전환하지 못했습니다.",
+    "claude_pane_source_missing": "패널 소스를 찾을 수 없습니다. 확인한 경로: {tried}",
+    "claude_pane_invalid_env": "Claude 설정의 env는 객체, CLAUDE_CODE_PLUGIN_DIRS는 문자열이어야 합니다.",
+    "claude_pane_invalid_sidecar": "usage-pane.json 형식이 잘못되었습니다",
+    "claude_pane_elapsed": "{minutes}분{seconds}초",
+    "claude_pane_remaining": "남음",
+    "claude_pane_hours_ago": "{count}시간 전"
   }
 }

usage_cli-0.32.0/installer/claude_pane.py

@@ -0,0 +1,175 @@
+"""Install the opt-in Claude Code pane without changing other plugins."""
+
+from __future__ import annotations
+
+import filecmp
+import json
+import os
+import shutil
+import sys
+from pathlib import Path
+
+from i18n import t as _t
+from installer import setup_hook
+from usage_common.usage_lang import detect_lang
+
+INSTALL_DIR = Path.home() / ".usage" / "claude-pane" / "usage-dash"
+PLUGIN_DIRS_KEY = "CLAUDE_CODE_PLUGIN_DIRS"
+
+
+def _same_path(left: str, right: str) -> bool:
+    return os.path.normpath(os.path.expanduser(left)) == os.path.normpath(os.path.expanduser(right))
+
+
+def _add_path(value: str, path: str) -> str:
+    parts = value.split(os.pathsep) if value else []
+    if not any(part and _same_path(part, path) for part in parts):
+        parts.append(path)
+    return os.pathsep.join(parts)
+
+
+def _remove_path(value: str, path: str) -> str:
+    parts = [part for part in value.split(os.pathsep) if not (part and _same_path(part, path))]
+    return os.pathsep.join(parts) if any(parts) else ""
+
+
+def _resolve_source() -> Path:
+    paths = [
+        Path(__file__).resolve().parent.parent / "claude_pane" / "usage-dash",
+        Path(sys.executable).resolve().parent.parent / "Resources" / "claude_pane" / "usage-dash",
+    ]
+    for path in paths:
+        if path.is_dir():
+            return path
+    raise SystemExit(_t("claude_pane_source_missing", tried=", ".join(map(str, paths))))
+
+
+def _status_argv() -> list[str]:
+    if getattr(sys, "frozen", False):
+        resources = str(Path(sys.executable).resolve().parent.parent / "Resources")
+        major, minor = sys.version_info[:2]
+        bootstrap = (
+            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()"
+        )
+        return [
+            "/usr/bin/env",
+            f"PYTHONHOME={resources}",
+            f"RESOURCEPATH={resources}",
+            sys.executable,
+            "-c",
+            bootstrap,
+        ]
+    return [
+        sys.executable,
+        str(Path(__file__).resolve().parent.parent / "usage_cli.py"),
+        "status",
+        "--json",
+    ]
+
+
+def _sidecar_text() -> str:
+    from i18n import I18N_PATH
+
+    bundle = json.loads(I18N_PATH.read_text(encoding="utf-8"))
+    english = bundle["en"]
+    table = bundle.get(detect_lang(), english)
+    strings = {
+        key: table.get(key) or value
+        for key, value in english.items()
+        if key.startswith("claude_pane_")
+    }
+    return (
+        json.dumps(
+            {"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 _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 _installed_is_current() -> bool:
+    source = _resolve_source()
+    shipped = {
+        path.relative_to(source)
+        for path in source.rglob("*")
+        if path.is_file() and not path.name.endswith(".test.ts")
+    }
+    # 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")}
+    if shipped != installed:
+        return False
+    if not all(filecmp.cmp(source / path, INSTALL_DIR / path, shallow=False) for path in shipped):
+        return False
+    try:
+        return (INSTALL_DIR / "usage-pane.json").read_text(encoding="utf-8") == _sidecar_text()
+    except OSError:
+        return False
+
+
+def _env(settings: dict[str, object]) -> dict[str, str]:
+    env = settings.get("env", {})
+    if not isinstance(env, dict) or not isinstance(env.get(PLUGIN_DIRS_KEY, ""), str):
+        raise SystemExit(_t("claude_pane_invalid_env"))
+    return env
+
+
+def enable_claude_pane() -> int:
+    _copy_pane()
+    settings = setup_hook._load_settings()
+    env = _env(settings)
+    env[PLUGIN_DIRS_KEY] = _add_path(env.get(PLUGIN_DIRS_KEY, ""), str(INSTALL_DIR.absolute()))
+    settings["env"] = env
+    setup_hook._save_settings(settings)
+    return 0
+
+
+def disable_claude_pane() -> int:
+    settings = setup_hook._load_settings()
+    env = _env(settings)
+    if PLUGIN_DIRS_KEY in env:
+        value = _remove_path(env[PLUGIN_DIRS_KEY], str(INSTALL_DIR.absolute()))
+        if value:
+            env[PLUGIN_DIRS_KEY] = value
+        else:
+            env.pop(PLUGIN_DIRS_KEY)
+        if not env:
+            settings.pop("env", None)
+        setup_hook._save_settings(settings)
+    if INSTALL_DIR.exists():
+        shutil.rmtree(INSTALL_DIR)
+    return 0
+
+
+def is_claude_pane_enabled() -> 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)
+    )
+
+
+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()

{usage_cli-0.31.5 → usage_cli-0.32.0}/menubar/actions.py

@@ -23,6 +23,7 @@ from installer.statusline_settings import (
     _toggle_statusline_settings,
 )
 from menubar.chrome import _make_alert
+from menubar.new_badge import dismiss_badge
 from usage_common.usage_lang import detect_lang
 
 logger = logging.getLogger(__name__)
@@ -200,3 +201,50 @@ def show_forwarder_mode_prompt_if_needed(language: str | None = None) -> None:
         except Exception:
             if os.environ.get("USAGE_DEBUG") == "1":
                 logger.warning("forwarder prompt dismissal failed", exc_info=True)
+
+
+class _PaneApp(_ActionApp, Protocol):
+    def _mark_switch_menu_action(self) -> None: ...
+    def _refresh(self) -> None: ...
+
+
+def toggle_claude_pane(app: _PaneApp) -> None:
+    import threading
+
+    dismiss_badge("claude_pane")
+    app._mark_switch_menu_action()
+    threading.Thread(target=toggle_claude_pane_in_background, args=(app,), daemon=True).start()
+
+
+def toggle_claude_pane_in_background(app: _ActionApp) -> None:
+    from installer import claude_pane
+
+    output = io.StringIO()
+    ok = False
+    enabled = False
+    try:
+        with contextlib.redirect_stdout(output), contextlib.redirect_stderr(output):
+            enabled = not claude_pane.is_claude_pane_enabled()
+            action = claude_pane.enable_claude_pane if enabled else claude_pane.disable_claude_pane
+            ok = action() == 0
+    except SystemExit as exc:
+        print(exc.code, file=output)
+    except Exception as exc:
+        print(f"{type(exc).__name__}: {exc}", file=output)
+    app.performSelectorOnMainThread_withObject_waitUntilDone_(
+        "_finishClaudePane:",
+        {"ok": ok, "enabled": enabled, "output": output.getvalue().strip()},
+        False,
+    )
+
+
+def finish_claude_pane(app: _PaneApp, result: dict[str, Any]) -> None:
+    alert = _make_alert()
+    if result.get("ok"):
+        key = "claude_pane_enabled_msg" if result.get("enabled") else "claude_pane_disabled_msg"
+        alert.setMessageText_(_t(app.language, key))
+    else:
+        alert.setMessageText_(_t(app.language, "claude_pane_action_failed"))
+        alert.setInformativeText_(str(result.get("output") or ""))
+    alert.runModal()
+    app._refresh()

{usage_cli-0.31.5 → usage_cli-0.32.0}/menubar/app.py

@@ -579,6 +579,12 @@ class AppDelegate(NSObject):
         alert.runModal()
         self._refresh()
 
+    def toggleClaudePane_(self, sender: Any) -> None:
+        menubar_actions.toggle_claude_pane(self)
+
+    def _finishClaudePane_(self, result: dict[str, Any]) -> None:
+        menubar_actions.finish_claude_pane(self, result)
+
     def toggleTerseMode_(self, sender: Any) -> None:
         self._mark_switch_menu_action()
         thread = threading.Thread(target=self._toggle_terse_mode_in_background, daemon=True)

{usage_cli-0.31.5 → usage_cli-0.32.0}/menubar/menu.py

@@ -11,7 +11,8 @@ from typing import Any, Protocol
 from AppKit import NSMakePoint, NSMenu, NSMenuItem
 
 from i18n import _t
-from installer import login_item
+from installer import claude_pane, login_item
+from menubar.new_badge import apply_badge
 from menubar.prefs import (
     _hide_agy_enabled,
     _hide_claude_enabled,
@@ -178,6 +179,16 @@ def build_switch_menu(app: _SwitchMenuApp, sender: Any) -> None:
             tooltip_key="terse_mode_tooltip",
         )
     )
+    claude_pane_item = build_menu_item(
+        app.language,
+        "claude_pane_menu",
+        "toggleClaudePane:",
+        target=app,
+        state=claude_pane.is_claude_pane_enabled(),
+        tooltip_key="claude_pane_tooltip",
+    )
+    apply_badge(claude_pane_item, app.language, "claude_pane")
+    menu.addItem_(claude_pane_item)
     app._switch_menu_action_taken = False
     menu.popUpMenuPositioningItem_atLocation_inView_(None, NSMakePoint(0, 0), sender)
     # Dismissing the menu without picking anything used to close the panel: