@raingor/pi-web-switch 0.4.1 → 0.4.3

package/README.ja.md

@@ -88,17 +88,32 @@ npm run build  # プロダクションビルド
 
 ## 🖥️ デスクトップアプリ（Electron）
 
-pi-web-switch はデスクトップアプリ（macOS / Windows / Linux）としても利用でき、専用ブランドアイコンを備えています。
+pi-web-switch は **macOS メニューバーアプリ**（および Windows/Linux トレイアプリ）としても利用可能 — アプリはメニューバーに常駐し、トレイアイコンのクリックで使用量サマリー（今日の tokens / コスト / リクエスト数 + 7 日間の sparkline + Top プロバイダ）がポップアップします。フルダッシュボードはトレイメニュー or ダブルクリックで開けます。
 
 ```bash
-# 開発モードで実行（Vite 開発サーバー + Electron、HMR 対応）
+# 開発モードで実行（Vite 開発サーバー + Electron、HMR 寂応）
 npm run electron:dev
 
-# インストーラー（DMG / NSIS / AppImage）を release/ にビルド
+# インストーラー（macOS DMG+ZIP / Windows NSIS / Linux AppImage）を release/ にビルド
 npm run electron:build
+
+# パッケージ化せずプロダクションビルドをプレビュー
+npm run electron:preview
 ```
 
-アプリアイコンは `build/`（`icon.icns` / `icon.ico` / `icon.png`）にあり、プラットフォームごとに electron-builder へ組み込まれています。開発モードでは実行時に macOS の Dock アイコンを設定します。
+### 🍹 macOS メニューバーモード
+
+パッケージ化された macOS アプリは **メニューバー専用アプリ** として実行 — Dock に表示されず、`Cmd+Q` でトレイメニューから終了。`electron-builder` の `extendInfo` で `LSUIElement = true` を設定して実装。開発モード（`electron:dev`）では Dock アイコンが表示されます（この Info.plist キーはパッケージビルドにのみ適用）。トレイアイコンは両モードで動作します。
+
+| トレイ操作 | 動作 |
+|------------|------|
+| クリック | 使用量ポップアップの切替（今日 + 7 日 tokens / コスト / リクエスト数、sparkline、Top プロバイダ） |
+| 右クリック | コンテキストメニュー：Dashboard を開く、使用量を更新、終了 |
+| メニュー → "開く Dashboard" | フル React Dashboard ウィンドウを開く |
+
+ポップアップは表示中 30 秒ごとに自動更新。トレイアイコンは 32×32 template PNG（`build/trayIconTemplate.png`）で明暗メニューバーに自動適合；`npm run tray:icon` で再生成。
+
+アプリアイコンは `build/`（`icon.icns` / `icon.ico` / `icon.png`）にあり；開発モードでは実行時に `public/icon-512.png` から macOS の Dock アイコンを設定します。
 
 ## 🏗️ 技術スタック
 
@@ -124,9 +139,12 @@ pi-web-switch は **pi コーディングエージェント拡張** としてイ
 
 | コマンド | 説明 |
 |---------|------|
-| `/pi-web-switch start` | ダッシュボード起動 http://localhost:5173 |
-| `/pi-web-switch stop` | サーバー停止 |
-| `/pi-web-switch status` | 実行状態を確認 |
+| `/pi-switch start` | ダッシュボード起動 http://localhost:5173 |
+| `/pi-switch stop` | サーバー停止 |
+| `/pi-switch status` | 実行状態を確認 |
+| `/pi-usage` | 使用量サマリー（今日 + 7 日）を端末に印字 — tokens / コスト / リクエスト数 / デイリー sparkline、ダッシュボード起動不要 |
+
+`/pi-usage` コマンドは `~/.pi/agent/sessions/*.jsonl` を直接読み込み、今日 + 直近 7 日の統計を集約します。どの pi セッションからでも一目で使用量を確認可能。macOS メニューバーポップアップと同じ内容を表示します。
 
 ### パッケージ構造
 
@@ -134,12 +152,18 @@ pi-web-switch は **pi コーディングエージェント拡張** としてイ
 pi-web-switch/
 ├── package.json           # npm パッケージ + pi.extensions + pi.skills
 ├── pi-package/
-│   ├── index.ts           # 拡張エントリ：/pi-web-switch コマンド登録
+│   ├── index.ts           # 拡張エントリ：/pi-switch、/pi-usage コマンド登録
 │   └── skills/
 │       └── pi-web-switch/
 │           └── SKILL.md   # 使用ドキュメント
 ├── server/
 │   └── pi-reader.ts       # サーバーサイド：~/.pi/agent/ 読み取り
+├── electron/              # デスクトップアプリ（macOS メニューバー / トレイ）
+│   ├── main.ts            # メインプロセス：トレイ、ポップアップ、IPC、ローカル API サーバー
+│   ├── api-server.ts      # ローカル HTTP サーバー（パッケージ版で dist/ + /api/pi/* を提供）
+│   ├── preload.ts         # contextBridge：settings/auth/models/usage IPC
+│   ├── popup.html         # メニューバー使用量ポップアップ
+│   └── popup-render.ts    # ポップアップ描画（今日/7 日 tokens、sparkline、Top プロバイダ）
 └── src/                   # React フロントエンド
 ```
 

package/README.md

@@ -139,17 +139,32 @@ The dev server automatically serves pi configuration via Vite middleware at `/ap
 
 ## 🖥️ Desktop App (Electron)
 
-pi-web-switch also runs as a desktop app (macOS / Windows / Linux) with its own branded app icon.
+pi-web-switch also runs as a **macOS menu bar app** (and a Windows/Linux tray app) — the app lives in your menu bar, and a single click on the tray icon pops up a compact usage summary (today's tokens / cost / requests + a 7-day sparkline + top providers). The full Dashboard is still available from the tray menu or by double-clicking the tray icon.
 
 ```bash
 # Run in development (Vite dev server + Electron with HMR)
 npm run electron:dev
 
-# Build installers (DMG / NSIS / AppImage) into release/
+# Build installers (DMG + ZIP for macOS, NSIS for Windows, AppImage for Linux) into release/
 npm run electron:build
+
+# Preview the production build without packaging
+npm run electron:preview
 ```
 
-App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`) and are wired into electron-builder per platform; in development the macOS dock icon is set at runtime.
+### 🍹 macOS menu bar mode
+
+The packaged macOS app runs as a **menu bar-only** app — it does not appear in the Dock, and `Cmd+Q` quits from the tray menu. This is wired in via `LSUIElement = true` in `electron-builder`'s `extendInfo`. In dev (`electron:dev`) the Dock icon still shows because that Info.plist key only applies to packaged builds; the tray icon works in both modes.
+
+| Tray interaction | What happens |
+|------------------|--------------|
+| Click | Toggle the usage popup (today + 7d tokens / cost / requests, sparkline, top providers) |
+| Right-click | Context menu: open Dashboard, refresh usage, quit |
+| Menu → "打开 Dashboard" | Open the full React Dashboard window |
+
+The popup auto-refreshes every 30 seconds while visible. The tray icon is a 16×16 template PNG (`build/trayIconTemplate.png`) that adapts to light/dark menu bars; regenerate it with `npm run tray:icon`.
+
+App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`); in development the macOS dock icon is set at runtime from `public/icon-512.png`.
 
 ## 🏗️ Tech Stack
 
@@ -170,10 +185,21 @@ App icons live in `build/` (`icon.icns` / `icon.ico` / `icon.png`) and are wired
 pi-web-switch/
 ├── index.html
 ├── package.json
-├── vite.config.ts          # Vite config + pi API plugin (middleware)
+├── vite.config.ts          # Vite config + pi API plugin (middleware) + popup entry
 ├── tsconfig.json
 ├── server/
 │   └── pi-reader.ts        # Server-side module: reads ~/.pi/agent/ files + parses sessions
+├── electron/               # Desktop app (macOS menu-bar / tray)
+│   ├── main.ts             # Main process: tray, popup window, IPC, local API server
+│   ├── api-server.ts       # Local HTTP server serving dist/ + /api/pi/* in packaged mode
+│   ├── preload.ts          # contextBridge: settings/auth/models/usage IPC
+│   ├── popup.html          # Menu-bar popup UI
+│   └── popup-render.ts     # Popup renderer (today/7d tokens, sparkline, top providers)
+├── scripts/
+│   └── generate-tray-icon.mjs  # Regenerates build/trayIconTemplate.png
+├── build/
+│   ├── trayIconTemplate.png    # 32x32 menu-bar template icon
+│   └── icon.icns / icon.ico / icon.png
 ├── public/
 │   └── pi.svg
 └── src/
@@ -224,7 +250,7 @@ Changes made in the UI are written back to these files in real time — the pi a
 
 ## 🧩 API Routes
 
-The Vite dev server exposes these endpoints at `/api/pi/*`:
+These endpoints at `/api/pi/*` are served by the Vite middleware in dev, and by the built-in HTTP server (`electron/api-server.ts`) in the packaged app — so the frontend works identically in both modes:
 
 | Method | Path | Description |
 |--------|------|-------------|
@@ -236,10 +262,29 @@ The Vite dev server exposes these endpoints at `/api/pi/*`:
 | POST | `/api/pi/models` | Write `models.json` |
 | GET | `/api/pi/builtin-providers` | List hardcoded built-in providers |
 | GET | `/api/pi/usage` | Aggregated token/cost/request data from sessions |
-| GET | `/api/pi/usage-range` | Date-range filtered usage with hourly/daily breakdown |
+| GET | `/api/pi/usage-range` | Date-range filtered usage (pi sessions) — `?range=today\|7d\|30d\|custom&from=&to=` |
+| GET | `/api/pi/all-usage-range` | Same shape, but combined across **all** sources (pi + cindy + claude + codex + atomcode + copilot) |
+| GET | `/api/pi/{cindy-pi\|claude\|codex\|opencode\|gemini\|grok\|atomcode\|copilot}-usage-range` | Per-source usage range |
+| GET | `/api/pi/copilot-usage-range` | Local Copilot CLI usage from `~/.copilot/session-store.db` (tokens / requests per day per model; no GitHub API or token required) |
+| GET | `/api/pi/copilot-config` | Read Copilot GitHub config (username, token) |
+| POST | `/api/pi/copilot-config` | Write Copilot GitHub config |
 | GET | `/api/pi/sessions` | Session list grouped by project |
-| DELETE | `/api/pi/session?path=` | Delete a session file (path must be under sessions/) |
+| DELETE | `/api/pi/session?path=` | Move a session file to trash (path must be under sessions/) |
+| POST | `/api/pi/session/trash` | Move a session to trash (body: `{ path }`) |
+| POST | `/api/pi/session/restore` | Restore a session from trash (body: `{ trashPath }`) |
+| GET | `/api/pi/session-preview` | Preview session messages — `?path=` |
+| GET | `/api/pi/trash` | List trashed sessions |
+| DELETE | `/api/pi/trash?path=` | Permanently delete a trashed session |
 | GET | `/api/pi/memory` | Read MEMORY.md, USER.md, failures.md |
+| POST | `/api/pi/memory/delete-entry` | Delete a memory entry (body: `{ filename, text }`) |
+| GET | `/api/pi/subagents` | Read subagent run history |
+| GET | `/api/pi/check-updates` | Check pi package updates |
+| POST | `/api/pi/apply-updates` | Apply package updates (body: `{ names }`) |
+| POST | `/api/pi/provider-test` | Test a provider connection (body: `{ baseUrl, apiKey }`) |
+| POST | `/api/pi/provider-models` | Fetch a provider's live model list (body: `{ baseUrl, apiKey, providerId }`) |
+| POST | `/api/pi/model-test` | Test a model (body: `{ baseUrl, modelId, apiKey, apiType }`) |
+
+All `-usage-range` endpoints accept `&refresh=1` to force a rescan, bypassing the 30-second session cache (the Dashboard refresh button sends this).
 
 ## 📦 Pi Package
 
@@ -263,9 +308,12 @@ Once installed, the following commands are available in your pi session:
 
 | Command | Description |
 |---------|-------------|
-| `/pi-web-switch start` | Launch the dashboard at `http://localhost:5173` |
-| `/pi-web-switch stop` | Stop the server |
-| `/pi-web-switch status` | Check if the dashboard is running |
+| `/pi-switch start` | Launch the dashboard at `http://localhost:5173` |
+| `/pi-switch stop` | Stop the server |
+| `/pi-switch status` | Check if the dashboard is running |
+| `/pi-usage` | Print a quick usage summary (today + 7 days) in the terminal — tokens / cost / requests / daily sparkline, without launching the dashboard |
+
+The `/pi-usage` command reads `~/.pi/agent/sessions/*.jsonl` directly and aggregates today + last-7-days stats, so you can see your usage at a glance from any pi session. It mirrors what the macOS menu bar popup shows.
 
 ### Package Structure
 

package/README.zh-CN.md

@@ -126,17 +126,32 @@ npm run preview # 预览生产构建
 
 ## 🖥️ 桌面应用（Electron）
 
-pi-web-switch 同样提供桌面应用（macOS / Windows / Linux），并带有专属品牌图标。
+pi-web-switch 同样提供 **macOS 菜单栏应用**（以及 Windows/Linux 托盘应用）—— 应用驻留在顶部菜单栏，点击托盘图标即可弹出使用量摘要（今日 tokens / 成本 / 请求数 + 7 天 sparkline + Top 提供商）。完整仪表盘仍可从托盘菜单或双击图标打开。
 
 ```bash
 # 开发模式运行（Vite 开发服务器 + Electron，支持 HMR）
 npm run electron:dev
 
-# 构建安装包（DMG / NSIS / AppImage）到 release/
+# 构建安装包（macOS DMG+ZIP / Windows NSIS / Linux AppImage）到 release/
 npm run electron:build
+
+# 不打包预览生产构建
+npm run electron:preview
 ```
 
-应用图标位于 `build/`（`icon.icns` / `icon.ico` / `icon.png`），已按平台接入 electron-builder；开发模式下会在运行时设置 macOS 程序坞图标。
+### 🍹 macOS 菜单栏模式
+
+打包后的 macOS 应用以 **纯菜单栏应用** 运行 —— 不出现在 Dock 中，`Cmd+Q` 从托盘菜单退出。通过 `electron-builder` 的 `extendInfo` 中 `LSUIElement = true` 实现。开发模式下（`electron:dev`）Dock 图标仍会显示（该 Info.plist 键仅对打包构建生效），托盘图标两种模式都可用。
+
+| 托盘交互 | 行为 |
+|----------|------|
+| 点击 | 切换使用量弹窗（今日 + 7 天 tokens / 成本 / 请求数、sparkline、Top 提供商） |
+| 右键 | 上下文菜单：打开 Dashboard、刷新使用量、退出 |
+| 菜单 → "打开 Dashboard" | 打开完整 React Dashboard 窗口 |
+
+弹窗可见时每 30 秒自动刷新。托盘图标是 32×32 template PNG（`build/trayIconTemplate.png`），自动适配明暗菜单栏；用 `npm run tray:icon` 重新生成。
+
+应用图标位于 `build/`（`icon.icns` / `icon.ico` / `icon.png`）；开发模式下会在运行时从 `public/icon-512.png` 设置 macOS 程序坞图标。
 
 ## 🏗️ 技术栈
 
@@ -162,9 +177,12 @@ pi-web-switch 可安装为 **pi 编码代理扩展**，在 pi 会话中直接启
 
 | 命令 | 说明 |
 |------|------|
-| `/pi-web-switch start` | 启动仪表盘 http://localhost:5173 |
-| `/pi-web-switch stop` | 停止服务器 |
-| `/pi-web-switch status` | 查看运行状态 |
+| `/pi-switch start` | 启动仪表盘 http://localhost:5173 |
+| `/pi-switch stop` | 娶止服务器 |
+| `/pi-switch status` | 查看运行状态 |
+| `/pi-usage` | 在终端打印使用量摘要（今日 + 7 天）—— tokens / 成本 / 请求数 / 每日 sparkline，无需启动仪表盘 |
+
+`/pi-usage` 命令直接读取 `~/.pi/agent/sessions/*.jsonl` 并聚合今日 + 最近 7 天统计，让你在任何 pi 会话中一眼看到使用量。它与 macOS 菜单栏弹窗显示的内容一致。
 
 ### 包结构
 
@@ -172,12 +190,18 @@ pi-web-switch 可安装为 **pi 编码代理扩展**，在 pi 会话中直接启
 pi-web-switch/
 ├── package.json           # npm 包 + pi.extensions + pi.skills
 ├── pi-package/
-│   ├── index.ts           # 扩展入口：注册 /pi-web-switch 命令
+│   ├── index.ts           # 扩展入口：注册 /pi-switch、/pi-usage 命令
 │   └── skills/
 │       └── pi-web-switch/
 │           └── SKILL.md   # 使用文档
 ├── server/
 │   └── pi-reader.ts       # 服务端：读取 ~/.pi/agent/ 文件
+├── electron/              # 桌面应用（macOS 菜单栏 / 托盘）
+│   ├── main.ts            # 主进程：托盘、弹窗、IPC、本地 API 服务器
+│   ├── api-server.ts      # 本地 HTTP 服务器（打包模式提供 dist/ + /api/pi/*）
+│   ├── preload.ts         # contextBridge：settings/auth/models/usage IPC
+│   ├── popup.html         # 菜单栏使用量弹窗
+│   └── popup-render.ts    # 弹窗渲染（今日/7 天 tokens、sparkline、Top 提供商）
 └── src/                   # React 前端
 ```
 

package/dist/index.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <title>pi-switch — pi Configuration Manager</title>
+    <link rel="icon" type="image/svg+xml" href="./pi.svg" />
+    <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
+    <link rel="manifest" href="./manifest.webmanifest" />
+    <meta name="theme-color" content="#2563eb" />
+    <meta name="description" content="Web UI for pi coding agent — configuration management, session browser, and usage dashboard" />
+    <script type="module" crossorigin src="./assets/main-eom_4fyA.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/main-M_eVNxKU.css">
+  </head>
+  <body class="bg-gray-950 text-gray-100 antialiased">
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@raingor/pi-web-switch",
   "private": false,
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
-  "main": "dist-electron/main.js",
+  "main": "dist/index.html",
   "description": "Web UI for pi coding agent — live configuration management, session browser, and memory viewer",
   "keywords": [
     "pi-package",
@@ -26,10 +26,7 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",
-    "preview": "vite preview",
-    "electron:dev": "node scripts/electron-dev.mjs",
-    "electron:build": "tsc -b && vite build && vite build --config vite.electron.config.ts && vite build --config vite.preload.config.ts && electron-builder",
-    "electron:preview": "vite build && vite build --config vite.electron.config.ts && vite build --config vite.preload.config.ts && env -u ELECTRON_RUN_AS_NODE npx electron ."
+    "preview": "vite preview"
   },
   "files": [
     "pi-package",
@@ -68,14 +65,10 @@
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.1.2",
     "@vitejs/plugin-react": "^4.4.1",
-    "electron": "^43.2.0",
-    "electron-builder": "^26.15.3",
-    "electron-vite": "^5.0.0",
     "tailwindcss": "^4.1.4",
     "typescript": "~5.8.3",
     "undici": "^8.9.0",
     "vite": "^6.3.2",
-    "vite-plugin-electron": "^1.1.0",
     "vite-plugin-pwa": "^1.3.0"
   },
   "build": {
@@ -85,20 +78,7 @@
       "output": "release"
     },
     "files": [
-      "dist/**/*",
-      "dist-electron/**/*"
-    ],
-    "mac": {
-      "target": "dmg",
-      "icon": "build/icon.icns"
-    },
-    "win": {
-      "target": "nsis",
-      "icon": "build/icon.ico"
-    },
-    "linux": {
-      "target": "AppImage",
-      "icon": "build/icon.png"
-    }
+      "dist/**/*"
+    ]
   }
 }

package/pi-package/index.ts

@@ -8,6 +8,7 @@ import { join, resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const PI_SWITCH_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const PI_DIR = join(homedir(), ".pi", "agent");
 
 let serverProcess: ReturnType<typeof spawn> | null = null;
 
@@ -17,8 +18,188 @@ function getPackageManager(): "npm" | "pnpm" | "yarn" {
   return "npm";
 }
 
+// ─── Usage reader ────────────────────────────────────────
+// Reads ~/.pi/agent/sessions/*.jsonl directly and aggregates today / 7d stats,
+// so the user can see usage at a glance without launching the dashboard.
+
+interface UsageRecord {
+  date: string;
+  hour?: number;
+  providerId: string;
+  modelId: string;
+  inputTokens: number;
+  outputTokens: number;
+  cacheReadTokens: number;
+  cacheWriteTokens: number;
+  requests: number;
+  cost: number;
+}
+
+const CN_TZ = "Asia/Shanghai";
+
+function cnDateParts(ts: string | number): { date: string; hour: number } {
+  const d = new Date(ts);
+  if (isNaN(d.getTime())) return { date: "unknown", hour: 0 };
+  const date = new Intl.DateTimeFormat("en-CA", {
+    timeZone: CN_TZ,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).format(d);
+  const hour = Number(
+    new Intl.DateTimeFormat("en-US", {
+      timeZone: CN_TZ,
+      hour: "2-digit",
+      hour12: false,
+    }).format(d)
+  );
+  return { date, hour: hour === 24 ? 0 : hour };
+}
+
+function parseSessionFile(filePath: string): UsageRecord[] {
+  const records: UsageRecord[] = [];
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    const lines = raw.split("\n").filter((l) => l.trim());
+
+    let currentProvider = "unknown";
+    let currentModel = "unknown";
+
+    for (const line of lines) {
+      try {
+        const obj = JSON.parse(line);
+        const type = obj.type;
+
+        if (type === "model_change") {
+          currentProvider = obj.provider || currentProvider;
+          currentModel = obj.modelId || currentModel;
+          continue;
+        }
+
+        if (type === "message" && obj.message?.role === "assistant") {
+          const usage = obj.message.usage;
+          if (!usage || !usage.input) continue;
+
+          const timestamp = obj.timestamp || obj.message.timestamp;
+          const { date, hour } = cnDateParts(timestamp);
+
+          records.push({
+            date,
+            hour,
+            providerId: obj.message.provider || currentProvider,
+            modelId: obj.message.model || currentModel,
+            inputTokens: usage.input ?? 0,
+            outputTokens: usage.output ?? 0,
+            cacheReadTokens: usage.cacheRead ?? 0,
+            cacheWriteTokens: usage.cacheWrite ?? 0,
+            requests: 1,
+            cost: usage.cost?.total ?? 0,
+          });
+        }
+      } catch {
+        // skip malformed lines
+      }
+    }
+  } catch {
+    // skip unreadable files
+  }
+  return records;
+}
+
+function readAllUsage(): UsageRecord[] {
+  const sessionsPath = join(PI_DIR, "sessions");
+  const { readdirSync, existsSync: exists, statSync } = require("node:fs");
+  if (!exists(sessionsPath)) return [];
+
+  const dirs = readdirSync(sessionsPath)
+    .filter((name: string) => name.startsWith("--"))
+    .map((name: string) => join(sessionsPath, name))
+    .filter((dir: string) => statSync(dir).isDirectory());
+
+  const allRecords: UsageRecord[] = [];
+  for (const dir of dirs) {
+    try {
+      const files = readdirSync(dir).filter((f: string) => f.endsWith(".jsonl"));
+      for (const file of files) {
+        const records = parseSessionFile(join(dir, file));
+        allRecords.push(...records);
+      }
+    } catch {
+      // skip unreadable directories
+    }
+  }
+  return allRecords;
+}
+
+function aggregateSummary() {
+  const records = readAllUsage();
+  // pi-reader buckets dates in Asia/Shanghai (CN_TZ); use the same timezone
+  // so "today" lines up with the session data around midnight UTC.
+  const cnDate = (d: Date) =>
+    new Intl.DateTimeFormat("en-CA", {
+      timeZone: "Asia/Shanghai",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+    }).format(d);
+  const today = cnDate(new Date());
+  const sevenDaysAgo = cnDate(new Date(Date.now() - 6 * 24 * 60 * 60 * 1000));
+
+  const todayRecs = records.filter((r) => r.date === today);
+  const sevenDayRecs = records.filter((r) => r.date >= sevenDaysAgo);
+
+  const sum = (recs: UsageRecord[]) => {
+    let tokens = 0,
+      cost = 0,
+      requests = 0;
+    for (const r of recs) {
+      tokens += r.inputTokens + r.outputTokens + r.cacheReadTokens + r.cacheWriteTokens;
+      cost += r.cost;
+      requests += r.requests;
+    }
+    return { tokens, cost, requests };
+  };
+
+  // Per-day breakdown for last 7 days
+  const dailyMap = new Map<string, { tokens: number; cost: number; requests: number }>();
+  for (const r of sevenDayRecs) {
+    const d = dailyMap.get(r.date) ?? { tokens: 0, cost: 0, requests: 0 };
+    d.tokens += r.inputTokens + r.outputTokens + r.cacheReadTokens + r.cacheWriteTokens;
+    d.cost += r.cost;
+    d.requests += r.requests;
+    dailyMap.set(r.date, d);
+  }
+  const daily = Array.from(dailyMap.entries())
+    .map(([date, v]) => ({ date, ...v }))
+    .sort((a, b) => a.date.localeCompare(b.date));
+
+  return {
+    today: sum(todayRecs),
+    sevenDays: sum(sevenDayRecs),
+    daily,
+  };
+}
+
+function formatTokens(n: number): string {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(2)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}K`;
+  return n.toLocaleString();
+}
+
+function formatCost(n: number): string {
+  if (n === 0) return "$0.00";
+  if (n < 0.01) return `$${n.toFixed(4)}`;
+  return `$${n.toFixed(2)}`;
+}
+
+function shortDate(iso: string): string {
+  const parts = iso.split("-");
+  if (parts.length !== 3) return iso;
+  return `${parts[1]}/${parts[2]}`;
+}
+
 export default function (api: ExtensionAPI, ctx: ExtensionContext) {
-  // Register a command to start/stop the web UI
+  // /pi-switch start|stop|status — launch the dashboard web UI
   api.registerCommand({
     name: "pi-switch",
     description: "Start or stop the pi-web-switch dashboard",
@@ -41,7 +222,7 @@ export default function (api: ExtensionAPI, ctx: ExtensionContext) {
           return ctx.say(
             <Box borderStyle="round" borderColor="yellow" paddingLeft={1} paddingRight={1}>
               <Text>pi-web-switch is not running.</Text>
-              <Text>Use `/pi-web-switch start` to launch the dashboard.</Text>
+              <Text>Use `/pi-switch start` to launch the dashboard.</Text>
             </Box>
           );
         }
@@ -84,14 +265,57 @@ export default function (api: ExtensionAPI, ctx: ExtensionContext) {
 
         serverProcess.unref();
 
-        // Wait a moment then check
         await new Promise((r) => setTimeout(r, 2000));
 
         return ctx.say(
           <Box borderStyle="round" borderColor="green" paddingLeft={1} paddingRight={1}>
             <Text>pi-web-switch started!</Text>
             <Text>Dashboard: http://localhost:{port}</Text>
-            <Text>Use `/pi-web-switch stop` to stop the server.</Text>
+            <Text>Use `/pi-switch stop` to stop the server.</Text>
+          </Box>
+        );
+      }
+    },
+  });
+
+  // /pi-usage — quick usage summary (today + 7d) in the terminal
+  api.registerCommand({
+    name: "pi-usage",
+    description: "Show pi usage summary (today / 7 days) without launching the dashboard",
+    params: Type.Object({}),
+    execute: async () => {
+      try {
+        const s = aggregateSummary();
+        const spark = s.daily
+          .map((d) => {
+            const max = Math.max(1, ...s.daily.map((x) => x.tokens));
+            const bars = Math.round((d.tokens / max) * 8);
+            return `${shortDate(d.date)} ${"█".repeat(bars)}${"░".repeat(8 - bars)} ${formatTokens(d.tokens)}`;
+          })
+          .join("\n");
+
+        return ctx.say(
+          <Box borderStyle="round" borderColor="green" paddingLeft={1} paddingRight={1}>
+            <Text bold>📊 pi usage summary</Text>
+            <Text> </Text>
+            <Text bold>Today ({new Date().toISOString().slice(0, 10)})</Text>
+            <Text>  Tokens:   {formatTokens(s.today.tokens)}</Text>
+            <Text>  Cost:     {formatCost(s.today.cost)}</Text>
+            <Text>  Requests: {s.today.requests}</Text>
+            <Text> </Text>
+            <Text bold>Last 7 days</Text>
+            <Text>  Tokens:   {formatTokens(s.sevenDays.tokens)}</Text>
+            <Text>  Cost:     {formatCost(s.sevenDays.cost)}</Text>
+            <Text>  Requests: {s.sevenDays.requests}</Text>
+            <Text> </Text>
+            <Text bold>Daily trend</Text>
+            <Text>{spark}</Text>
+          </Box>
+        );
+      } catch (err) {
+        return ctx.say(
+          <Box borderStyle="round" borderColor="red" paddingLeft={1} paddingRight={1}>
+            <Text>Failed to read usage: {String(err)}</Text>
           </Box>
         );
       }