usage-cli 0.31.6__tar.gz → 0.32.1__tar.gz

{usage_cli-0.31.6 → usage_cli-0.32.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usage-cli
-Version: 0.31.6
+Version: 0.32.1
 Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具（也提供終端機 TUI）
 License-Expression: AGPL-3.0-only
 Requires-Python: >=3.13
@@ -57,7 +57,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 **Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
 
-**Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
+**Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Claude Code Side Pane](#claude-code-side-pane) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
 
 ## What You Get
 
@@ -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 and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
 - **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
@@ -146,6 +147,34 @@ Once set up, the bottom of the Claude Code window will show a status line like t
   <img src="docs/statusline.en.gif" alt="Claude Code statusLine display (English)" width="900">
 </p>
 
+## Claude Code Side Pane
+
+See your quota, other conversations, and background jobs without leaving Claude Code. Available on macOS and Windows.
+
+<p align="center"><img src="docs/side-pane.png" alt="Claude Code side pane showing quotas, conversations, and background jobs" width="637"></p>
+
+**What you’ll see**
+
+- **Quotas:** Your 5-hour and weekly limits.
+- **Claude conversations:** Conversations waiting for your permission or MCP input are marked in yellow.
+- **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**.
+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`.
+
+<details>
+<summary>Compatibility and updates</summary>
+
+- Requires a recent Claude Code with mod support; tested with 2.1.289.
+- The pane docks on the right only in Claude Code's fullscreen layout; otherwise it appears above the prompt. On Windows, enabling the pane turns the fullscreen layout on as well, and turning the pane off switches it back.
+- The built-in macOS Terminal supports only 256 colors and may show a gray background. Select an ANSI dark theme in `/config`.
+- When the usage app starts, it automatically updates an enabled pane to the bundled version.
+
+</details>
+
 ## Windows Support
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.

{usage_cli-0.31.6 → usage_cli-0.32.1}/README.md

@@ -37,7 +37,7 @@ It lands in your Applications folder automatically. Open it once; if macOS 15 or
 
 **Not on macOS?** `uvx usage-cli` runs the terminal interface anywhere, Linux included — no install, no menu bar.
 
-**Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
+**Jump to:** [What You Get](#what-you-get) · [Privacy](#privacy--data-sources) · [Requirements](#requirements) · [Install](#install) · [Status Line](#first-launch-set-up-the-status-line) · [Claude Code Side Pane](#claude-code-side-pane) · [Windows](#windows-support) · [Themes](#theme-gallery) · [Troubleshooting](#troubleshooting) · [Comparison](#comparison) · [Not a Fit?](#when-usage-isnt-the-right-fit) · [Development](#development)
 
 ## What You Get
 
@@ -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 and Windows):** Quotas, conversations, and background jobs inside Claude Code. [See the side pane](#claude-code-side-pane).
 - **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
@@ -126,6 +127,34 @@ Once set up, the bottom of the Claude Code window will show a status line like t
   <img src="docs/statusline.en.gif" alt="Claude Code statusLine display (English)" width="900">
 </p>
 
+## Claude Code Side Pane
+
+See your quota, other conversations, and background jobs without leaving Claude Code. Available on macOS and Windows.
+
+<p align="center"><img src="docs/side-pane.png" alt="Claude Code side pane showing quotas, conversations, and background jobs" width="637"></p>
+
+**What you’ll see**
+
+- **Quotas:** Your 5-hour and weekly limits.
+- **Claude conversations:** Conversations waiting for your permission or MCP input are marked in yellow.
+- **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**.
+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`.
+
+<details>
+<summary>Compatibility and updates</summary>
+
+- Requires a recent Claude Code with mod support; tested with 2.1.289.
+- The pane docks on the right only in Claude Code's fullscreen layout; otherwise it appears above the prompt. On Windows, enabling the pane turns the fullscreen layout on as well, and turning the pane off switches it back.
+- The built-in macOS Terminal supports only 256 colors and may show a gray background. Select an ANSI dark theme in `/config`.
+- When the usage app starts, it automatically updates an enabled pane to the bundled version.
+
+</details>
+
 ## Windows Support
 
 Windows has the full core experience: the system-tray UI, Claude Code status-line hook, and Codex history parsing all work natively. Download `usage-windows.zip` from the [latest GitHub Release](https://github.com/aqua5230/usage/releases/latest), unzip it, then run `usage.exe`—no installer is needed. If SmartScreen shows **Windows protected your PC** on first launch, click **More info** → **Run anyway**. The tray UI requires Microsoft Edge WebView2 Runtime, which is normally included with Windows 10 and 11.

{usage_cli-0.31.6 → usage_cli-0.32.1}/i18n.json

@@ -425,7 +425,61 @@
     "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_fullscreen_enabled_note": "已一併開啟 Claude Code 的全螢幕介面，讓面板顯示在右側。取消勾選側邊面板時會改回。",
+    "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 +907,61 @@
     "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_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.",
+    "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 +1389,61 @@
     "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_fullscreen_enabled_note": "已一并开启 Claude Code 的全屏界面，让面板显示在右侧。取消勾选侧边面板时会改回。",
+    "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 +1871,61 @@
     "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_fullscreen_enabled_note": "Claude Code のフルスクリーンレイアウトを有効にし、パネルを右側に表示できるようにしました。サイドパネルをオフにすると元に戻ります。",
+    "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 +2353,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_fullscreen_enabled_note": "Claude Code의 전체 화면 레이아웃도 켜서 패널이 오른쪽에 표시됩니다. 사이드 패널을 끄면 원래대로 돌아갑니다.",
+    "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.1/installer/claude_pane.py

@@ -0,0 +1,203 @@
+"""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) and sys.platform == "win32":
+        return [sys.executable, "status", "--json"]
+    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 is_fullscreen_layout() -> bool:
+    return setup_hook._load_settings().get("tui") == "fullscreen"
+
+
+def enable_fullscreen_layout() -> None:
+    settings = setup_hook._load_settings()
+    settings["tui"] = "fullscreen"
+    usage = settings.get("usage")
+    if not isinstance(usage, dict):
+        usage = {}
+        settings["usage"] = usage
+    usage["claudePaneSetFullscreen"] = True
+    setup_hook._save_settings(settings)
+
+
+def disable_claude_pane() -> 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()))
+        if value:
+            env[PLUGIN_DIRS_KEY] = value
+        else:
+            env.pop(PLUGIN_DIRS_KEY)
+        if not env:
+            settings.pop("env", None)
+        changed = True
+    usage = settings.get("usage")
+    if isinstance(usage, dict) and usage.get("claudePaneSetFullscreen") is True:
+        if settings.get("tui") == "fullscreen":
+            settings.pop("tui")
+        usage.pop("claudePaneSetFullscreen")
+        if not usage:
+            settings.pop("usage")
+        changed = True
+    if changed:
+        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.6 → usage_cli-0.32.1}/main.py

@@ -314,6 +314,11 @@ async def run_tui(mock: bool, interval: int, force_group: int | None = None) ->
 
 
 def main() -> None:
+    if sys.argv[1:2] == ["status"]:
+        import usage_cli
+
+        usage_cli.main()
+        return
     _setup_logging()
     args = parse_args()
     if args.doctor: