@leeandrew94/ccm 0.1.12 → 0.2.0

package/README.md

@@ -65,6 +65,45 @@ ccm ps
 | `ccm check` | Check if claude is installed |
 | `ccm test [name]` | Test API connection (omit name to test all) |
 | `ccm balance [name]` | Query model balance/credits (omit name to query all) |
+| `ccm sessions` | Browse session history (interactive terminal list) |
+| `ccm sessions --web` | Open session viewer in browser |
+| `ccm sessions --restore [id]` | Restore a deleted session from trash |
+| `ccm sessions --purge` | Permanently empty the trash |
+
+## Session Management
+
+Browse, search, and restore your Claude Code conversation history.
+
+<p align="center">
+  <img src="assets/sessions-web.png" alt="ccm sessions web" width="800" />
+</p>
+
+```bash
+# Interactive terminal list — navigate with arrow keys
+ccm sessions
+
+# Open full conversation viewer in browser
+ccm sessions --web
+
+# Restore the most recently deleted session
+ccm sessions --restore
+
+# Restore a specific session by ID
+ccm sessions --restore <sessionId>
+
+# Permanently delete all trashed sessions
+ccm sessions --purge
+```
+
+**Terminal list controls:**
+| Key | Action |
+|---|---|
+| `↑↓` | Navigate |
+| `Enter` | Open in browser |
+| `d` | Delete session (moves to trash) |
+| `D` | Delete all sessions (moves to trash) |
+| `←→` | Previous/next page |
+| `q` | Quit |
 
 ## Shell Completions
 
@@ -104,7 +143,7 @@ Profile config file `~/.ccm/profiles.json` (managed via `ccm add` / `ccm edit`):
 
 ## Star History
 
-[![Star History Chart](https://api.star-history.com/svg?repos=leeandrew94/ccm-cli&type=Date)](https://star-history.com/#leeandrew94/ccm-cli&Date)
+[![Star History Chart](https://api.star-history.com/chart?repos=leeandrew94/ccm-cli&type=date&legend=top-left)](https://www.star-history.com/?type=date&repos=leeandrew94%2Fccm-cli)
 
 ## License
 

package/README.zh.md

@@ -65,6 +65,45 @@ ccm ps
 | `ccm check` | 检查 claude 是否安装 |
 | `ccm test [name]` | 测试 API 连接（不指定则测试全部） |
 | `ccm balance [name]` | 查询模型余额（不指定则查询全部） |
+| `ccm sessions` | 浏览会话历史（终端交互式列表） |
+| `ccm sessions --web` | 在浏览器中打开会话查看器 |
+| `ccm sessions --restore [id]` | 从回收站恢复已删除的会话 |
+| `ccm sessions --purge` | 永久清空回收站 |
+
+## 会话管理
+
+浏览、搜索、恢复你的 Claude Code 对话历史。
+
+<p align="center">
+  <img src="assets/sessions-web.png" alt="ccm sessions web" width="800" />
+</p>
+
+```bash
+# 终端交互式列表 — 方向键导航
+ccm sessions
+
+# 在浏览器中查看完整对话
+ccm sessions --web
+
+# 恢复最近一次删除的会话
+ccm sessions --restore
+
+# 恢复指定会话
+ccm sessions --restore <sessionId>
+
+# 永久清空回收站
+ccm sessions --purge
+```
+
+**终端列表操作：**
+| 按键 | 功能 |
+|---|---|
+| `↑↓` | 上下选择 |
+| `Enter` | 在浏览器中打开 |
+| `d` | 删除会话（移入回收站） |
+| `D` | 清空全部会话（移入回收站） |
+| `←→` | 上一页/下一页 |
+| `q` | 退出 |
 
 ## Shell 补全
 
@@ -104,7 +143,7 @@ Profile 配置文件 `~/.ccm/profiles.json`（通过 `ccm add` / `ccm edit` 管
 
 ## Star History
 
-[![Star History Chart](https://api.star-history.com/svg?repos=leeandrew94/ccm-cli&type=Date)](https://star-history.com/#leeandrew94/ccm-cli&Date)
+[![Star History Chart](https://api.star-history.com/chart?repos=leeandrew94/ccm-cli&type=date&legend=top-left)](https://www.star-history.com/?type=date&repos=leeandrew94%2Fccm-cli)
 
 ## License
 

package/bin/ccm.js

@@ -254,7 +254,7 @@ function cmdLaunch(args) {
   writeRun(process.pid, args.name, "");
   info(`Launching claude with profile '${args.name}'...`);
   console.log();
-  const child = spawn("claude", ["--settings", settingsPath], {
+  const child = spawn("claude", ["--settings", settingsPath, ...args.extraArgs || []], {
     stdio: "inherit"
   });
   child.on("exit", (code) => {
@@ -806,6 +806,1095 @@ var BASH_COMPLETION = `_ccm_completions() {
 
 complete -F _ccm_completions ccm`;
 
+// src/session-data.ts
+import fs4 from "fs";
+import path4 from "path";
+import os2 from "os";
+var CLAUDE_DIR = path4.join(os2.homedir(), ".claude");
+var HISTORY_FILE = path4.join(CLAUDE_DIR, "history.jsonl");
+var PROJECTS_DIR = path4.join(CLAUDE_DIR, "projects");
+var TRASH_DIR = path4.join(os2.homedir(), ".ccm", "session-trash");
+var TRASH_EXPIRE_DAYS = 30;
+function readJsonl(filePath) {
+  if (!fs4.existsSync(filePath)) return [];
+  const lines = fs4.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
+  const results = [];
+  for (const line of lines) {
+    try {
+      results.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  return results;
+}
+function atomicWriteJsonl(filePath, lines) {
+  const tmp = filePath + ".tmp";
+  fs4.writeFileSync(tmp, lines.join("\n"), "utf-8");
+  fs4.renameSync(tmp, filePath);
+}
+function getHistoryEntries() {
+  const entries = readJsonl(HISTORY_FILE);
+  return entries.filter((e) => e.sessionId && e.display && !e.display.startsWith("/") && e.display !== "exit").map((e) => ({
+    sessionId: e.sessionId,
+    display: e.display,
+    timestamp: e.timestamp,
+    project: e.project || ""
+  }));
+}
+function getSessionsList() {
+  const entries = getHistoryEntries();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const list = grouped.get(entry.sessionId) || [];
+    list.push(entry);
+    grouped.set(entry.sessionId, list);
+  }
+  const sessions = [];
+  for (const [sessionId, group] of grouped) {
+    group.sort((a, b) => a.timestamp - b.timestamp);
+    const first = group[0];
+    const projectPath = first.project;
+    const projectName = projectPath.split("/").pop() || projectPath;
+    sessions.push({
+      sessionId,
+      firstQuestion: first.display,
+      timestamp: first.timestamp,
+      project: projectPath,
+      projectName,
+      messageCount: group.length
+    });
+  }
+  sessions.sort((a, b) => b.timestamp - a.timestamp);
+  return sessions;
+}
+function findSessionJsonl(sessionId) {
+  if (!fs4.existsSync(PROJECTS_DIR)) return null;
+  const projectDirs = fs4.readdirSync(PROJECTS_DIR);
+  for (const dir of projectDirs) {
+    const filePath = path4.join(PROJECTS_DIR, dir, `${sessionId}.jsonl`);
+    if (fs4.existsSync(filePath)) return filePath;
+  }
+  return null;
+}
+function getSessionMessages(sessionId) {
+  const filePath = findSessionJsonl(sessionId);
+  if (!filePath) return [];
+  const entries = readJsonl(filePath);
+  const messages = [];
+  for (const entry of entries) {
+    if (entry.type === "user" && entry.message?.content && typeof entry.message.content === "string") {
+      messages.push({
+        role: "user",
+        content: entry.message.content,
+        timestamp: entry.timestamp || ""
+      });
+    } else if (entry.type === "assistant" && entry.message?.content) {
+      const textParts = [];
+      let model;
+      if (entry.message.model) model = entry.message.model;
+      if (Array.isArray(entry.message.content)) {
+        for (const block of entry.message.content) {
+          if (block.type === "text" && block.text) {
+            textParts.push(block.text);
+          }
+        }
+      }
+      if (textParts.length > 0) {
+        messages.push({
+          role: "assistant",
+          content: textParts.join("\n"),
+          timestamp: entry.timestamp || "",
+          model
+        });
+      }
+    }
+  }
+  return messages;
+}
+function getModelForSession(sessionId) {
+  const filePath = findSessionJsonl(sessionId);
+  if (!filePath) return null;
+  const entries = readJsonl(filePath);
+  for (const entry of entries) {
+    if (entry.type === "assistant" && entry.message?.model) {
+      return entry.message.model;
+    }
+  }
+  return null;
+}
+function resolveProfileName(model) {
+  const profiles = loadProfiles();
+  for (const [name, profile] of Object.entries(profiles)) {
+    if (profile.ANTHROPIC_MODEL === model) return name;
+  }
+  return null;
+}
+function getSessionTitle(sessionId) {
+  const filePath = findSessionJsonl(sessionId);
+  if (!filePath) return null;
+  const entries = readJsonl(filePath);
+  for (const entry of entries) {
+    if (entry.type === "ai-title" && entry.aiTitle) {
+      return entry.aiTitle;
+    }
+  }
+  return null;
+}
+function ensureTrashDir() {
+  fs4.mkdirSync(TRASH_DIR, { recursive: true });
+}
+function extractHistoryForSession(sessionId) {
+  if (!fs4.existsSync(HISTORY_FILE)) return [];
+  const lines = fs4.readFileSync(HISTORY_FILE, "utf-8").split("\n").filter(Boolean);
+  const matched = [];
+  for (const line of lines) {
+    try {
+      const entry = JSON.parse(line);
+      if (entry.sessionId === sessionId) matched.push(entry);
+    } catch {
+    }
+  }
+  return matched;
+}
+function filterHistoryBySession(sessionId) {
+  if (!fs4.existsSync(HISTORY_FILE)) return;
+  const lines = fs4.readFileSync(HISTORY_FILE, "utf-8").split("\n");
+  const filtered = lines.filter((line) => {
+    if (!line.trim()) return false;
+    try {
+      const entry = JSON.parse(line);
+      return entry.sessionId !== sessionId;
+    } catch {
+      return true;
+    }
+  });
+  atomicWriteJsonl(HISTORY_FILE, filtered);
+}
+function deleteSession(sessionId) {
+  ensureTrashDir();
+  const historyEntries = extractHistoryForSession(sessionId);
+  const filePath = findSessionJsonl(sessionId);
+  let originalProject = "";
+  if (filePath) {
+    originalProject = path4.basename(path4.dirname(filePath));
+    const destJsonl = path4.join(TRASH_DIR, `${sessionId}.jsonl`);
+    fs4.copyFileSync(filePath, destJsonl);
+    fs4.unlinkSync(filePath);
+    const sessionDir = path4.join(path4.dirname(filePath), sessionId);
+    if (fs4.existsSync(sessionDir)) {
+      const destDir = path4.join(TRASH_DIR, sessionId);
+      fs4.cpSync(sessionDir, destDir, { recursive: true });
+      fs4.rmSync(sessionDir, { recursive: true, force: true });
+    }
+  }
+  const meta = {
+    sessionId,
+    deletedAt: Date.now(),
+    originalProject,
+    historyEntries
+  };
+  fs4.writeFileSync(
+    path4.join(TRASH_DIR, `${sessionId}.meta.json`),
+    JSON.stringify(meta, null, 2),
+    "utf-8"
+  );
+  filterHistoryBySession(sessionId);
+}
+function deleteAllSessions() {
+  ensureTrashDir();
+  const sessions = getSessionsList();
+  for (const session of sessions) {
+    const historyEntries = extractHistoryForSession(session.sessionId);
+    const filePath = findSessionJsonl(session.sessionId);
+    if (filePath) {
+      const destJsonl = path4.join(TRASH_DIR, `${session.sessionId}.jsonl`);
+      fs4.copyFileSync(filePath, destJsonl);
+      fs4.unlinkSync(filePath);
+      const sessionDir = path4.join(path4.dirname(filePath), session.sessionId);
+      if (fs4.existsSync(sessionDir)) {
+        const destDir = path4.join(TRASH_DIR, session.sessionId);
+        fs4.cpSync(sessionDir, destDir, { recursive: true });
+        fs4.rmSync(sessionDir, { recursive: true, force: true });
+      }
+    }
+    const meta = {
+      sessionId: session.sessionId,
+      deletedAt: Date.now(),
+      originalProject: session.projectName,
+      historyEntries
+    };
+    fs4.writeFileSync(
+      path4.join(TRASH_DIR, `${session.sessionId}.meta.json`),
+      JSON.stringify(meta, null, 2),
+      "utf-8"
+    );
+  }
+  if (fs4.existsSync(HISTORY_FILE)) {
+    atomicWriteJsonl(HISTORY_FILE, []);
+  }
+}
+function restoreSession(sessionId) {
+  const metaPath = path4.join(TRASH_DIR, `${sessionId}.meta.json`);
+  if (!fs4.existsSync(metaPath)) return false;
+  const meta = JSON.parse(fs4.readFileSync(metaPath, "utf-8"));
+  const destDir = findProjectDirForRestore(meta.originalProject);
+  const trashJsonl = path4.join(TRASH_DIR, `${sessionId}.jsonl`);
+  if (fs4.existsSync(trashJsonl) && destDir) {
+    fs4.copyFileSync(trashJsonl, path4.join(destDir, `${sessionId}.jsonl`));
+    fs4.unlinkSync(trashJsonl);
+  }
+  const trashSessionDir = path4.join(TRASH_DIR, sessionId);
+  if (fs4.existsSync(trashSessionDir) && destDir) {
+    const restoredDir = path4.join(destDir, sessionId);
+    fs4.cpSync(trashSessionDir, restoredDir, { recursive: true });
+    fs4.rmSync(trashSessionDir, { recursive: true, force: true });
+  }
+  if (meta.historyEntries && meta.historyEntries.length > 0) {
+    const newLines = meta.historyEntries.map((e) => JSON.stringify(e));
+    if (fs4.existsSync(HISTORY_FILE)) {
+      const existing = fs4.readFileSync(HISTORY_FILE, "utf-8");
+      const combined = existing.trimEnd() + "\n" + newLines.join("\n") + "\n";
+      atomicWriteJsonl(HISTORY_FILE, combined.split("\n"));
+    } else {
+      atomicWriteJsonl(HISTORY_FILE, newLines);
+    }
+  }
+  fs4.unlinkSync(metaPath);
+  return true;
+}
+function findProjectDirForRestore(projectName) {
+  if (!fs4.existsSync(PROJECTS_DIR)) return null;
+  const dirs = fs4.readdirSync(PROJECTS_DIR);
+  for (const dir of dirs) {
+    if (dir.endsWith(projectName) || dir.includes(projectName)) {
+      const fullPath = path4.join(PROJECTS_DIR, dir);
+      if (fs4.statSync(fullPath).isDirectory()) return fullPath;
+    }
+  }
+  if (dirs.length > 0) {
+    const first = path4.join(PROJECTS_DIR, dirs[0]);
+    if (fs4.statSync(first).isDirectory()) return first;
+  }
+  return null;
+}
+function getTrashSessions() {
+  ensureTrashDir();
+  const files = fs4.readdirSync(TRASH_DIR);
+  const metas = [];
+  for (const file of files) {
+    if (file.endsWith(".meta.json")) {
+      try {
+        const meta = JSON.parse(fs4.readFileSync(path4.join(TRASH_DIR, file), "utf-8"));
+        metas.push(meta);
+      } catch {
+      }
+    }
+  }
+  metas.sort((a, b) => b.deletedAt - a.deletedAt);
+  return metas;
+}
+function purgeTrash() {
+  ensureTrashDir();
+  const files = fs4.readdirSync(TRASH_DIR);
+  for (const file of files) {
+    const fullPath = path4.join(TRASH_DIR, file);
+    if (fs4.statSync(fullPath).isDirectory()) {
+      fs4.rmSync(fullPath, { recursive: true, force: true });
+    } else {
+      fs4.unlinkSync(fullPath);
+    }
+  }
+}
+function cleanupOldTrash() {
+  ensureTrashDir();
+  const cutoff = Date.now() - TRASH_EXPIRE_DAYS * 24 * 60 * 60 * 1e3;
+  const metas = getTrashSessions();
+  let cleaned = 0;
+  for (const meta of metas) {
+    if (meta.deletedAt < cutoff) {
+      const jsonlPath = path4.join(TRASH_DIR, `${meta.sessionId}.jsonl`);
+      if (fs4.existsSync(jsonlPath)) fs4.unlinkSync(jsonlPath);
+      const sessionDir = path4.join(TRASH_DIR, meta.sessionId);
+      if (fs4.existsSync(sessionDir)) fs4.rmSync(sessionDir, { recursive: true, force: true });
+      const metaPath = path4.join(TRASH_DIR, `${meta.sessionId}.meta.json`);
+      if (fs4.existsSync(metaPath)) fs4.unlinkSync(metaPath);
+      cleaned++;
+    }
+  }
+  return cleaned;
+}
+
+// src/session-server.ts
+import { exec } from "child_process";
+import http2 from "http";
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
+  exec(cmd);
+}
+function jsonResponse(res, data, status = 200) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
+}
+function startSessionServer(port = 13501) {
+  return new Promise((resolve) => {
+    const server = http2.createServer((req, res) => {
+      const url = new URL(req.url || "/", `http://localhost:${port}`);
+      if (req.method === "GET" && (url.pathname === "/" || /^\/session\/[0-9a-f-]+$/.test(url.pathname))) {
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(getHTML());
+        return;
+      }
+      if (url.pathname === "/api/sessions" && req.method === "GET") {
+        const sessions = getSessionsList();
+        jsonResponse(res, sessions);
+        return;
+      }
+      const sessionMatch = url.pathname.match(/^\/api\/session\/([0-9a-f-]+)$/);
+      if (sessionMatch) {
+        const sessionId = sessionMatch[1];
+        if (req.method === "GET") {
+          const messages = getSessionMessages(sessionId);
+          const model = getModelForSession(sessionId);
+          const profile = model ? resolveProfileName(model) : null;
+          const restoreCmd = profile ? `ccm ${profile} --resume ${sessionId}` : `ccm <model> --resume ${sessionId}`;
+          const title = getSessionTitle(sessionId);
+          jsonResponse(res, { messages, model, profile, restoreCmd, title });
+          return;
+        }
+        if (req.method === "DELETE") {
+          deleteSession(sessionId);
+          jsonResponse(res, { ok: true });
+          return;
+        }
+      }
+      res.writeHead(404);
+      res.end("Not Found");
+    });
+    server.listen(port, () => {
+      const url = `http://localhost:${port}`;
+      console.log(`
+  ccm sessions web: ${url}
+`);
+      openBrowser(url);
+      resolve(server);
+    });
+  });
+}
+function getHTML() {
+  const BT = String.fromCharCode(96);
+  const jsCode = `
+let sessions = [];
+let currentSession = null;
+
+async function loadSessions() {
+  const res = await fetch('/api/sessions');
+  sessions = await res.json();
+  renderSessionList(sessions);
+  const match = location.pathname.match(/\\/session\\/([0-9a-f-]+)/);
+  if (match) selectSession(match[1], false);
+}
+
+window.addEventListener('popstate', function(e) {
+  if (e.state && e.state.sessionId) selectSession(e.state.sessionId, false);
+});
+
+function renderSessionList(list) {
+  const el = document.getElementById('sessionList');
+  el.innerHTML = list.map((s, i) => {
+    const date = new Date(s.timestamp);
+    const time = date.toLocaleDateString('zh-CN', { year: 'numeric', month: '2-digit', day: '2-digit' }) + ' ' + date.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' });
+    const active = currentSession === s.sessionId ? ' active' : '';
+    return '<div class="session-item' + active + '" data-id="' + s.sessionId + '" onclick="selectSession(\\'' + s.sessionId + '\\')">' +
+      '<div class="time">' + time + '</div>' +
+      '<div class="question">' + escHtml(s.firstQuestion) + '</div>' +
+      '</div>';
+  }).join('');
+}
+
+async function selectSession(sessionId, pushState) {
+  currentSession = sessionId;
+  if (pushState !== false) history.pushState({ sessionId }, '', '/session/' + sessionId);
+  renderSessionList(getFilteredList());
+  const res = await fetch('/api/session/' + sessionId);
+  const data = await res.json();
+  const session = sessions.find(s => s.sessionId === sessionId);
+  const date = session ? new Date(session.timestamp) : new Date();
+  const dateStr = date.toLocaleString('zh-CN');
+  const mainEl = document.getElementById('main');
+  const questions = data.messages.filter(m => m.role === 'user');
+  let html = '<div class="main-header">' +
+    '<h1>' + escHtml(session?.firstQuestion || data.title || '\u65E0\u6807\u9898') + '</h1>' +
+    '<div class="meta">' +
+    '<span class="meta-date"><svg width="13" height="13" viewBox="0 0 13 13" fill="none"><rect x="1" y="3" width="11" height="9" rx="1.5" stroke="currentColor" stroke-width="1.3"/><path d="M4 1.5V3M9 1.5V3M1 6h11" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>' + dateStr + '</span>' +
+    (data.model ? '<span><svg width="13" height="13" viewBox="0 0 13 13" fill="none"><circle cx="6.5" cy="6.5" r="5.5" stroke="currentColor" stroke-width="1.3"/><path d="M6.5 3.5V6.5L8.5 8" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>' + escHtml(data.model) + '</span>' : '') +
+    '</div>' +
+    '<div class="restore-bar">' +
+    '<code>' + escHtml(data.restoreCmd) + '</code>' +
+    '<button class="copy-btn" onclick="copyCmd()">\u590D\u5236</button>' +
+    '</div></div>' +
+    '<div class="messages" id="messages">';
+  data.messages.forEach((m, i) => {
+    const time = m.timestamp ? new Date(m.timestamp).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }) : '';
+    if (m.role === 'user') {
+      html += '<div class="message user" id="msg-' + i + '"><div class="avatar">U</div><div><div class="bubble">' + renderMarkdown(m.content) + '</div><div class="time">' + time + '</div></div></div>';
+    } else {
+      html += '<div class="message ai" id="msg-' + i + '"><div class="avatar">AI</div><div>' + (m.model ? '<div class="model-tag">' + escHtml(m.model) + '</div>' : '') + '<div class="bubble">' + renderMarkdown(m.content) + '</div><div class="time">' + time + '</div></div></div>';
+    }
+  });
+  html += '<div class="message-count">\u5171 ' + data.messages.length + ' \u6761\u6D88\u606F</div></div>';
+  mainEl.innerHTML = html;
+  document.getElementById('indexPanel').style.display = '';
+  const indexEl = document.getElementById('indexList');
+  let idx = 0;
+  indexEl.innerHTML = questions.map((q, i) => {
+    const msgIdx = data.messages.indexOf(q);
+    const text = q.content.length > 30 ? q.content.slice(0, 30) + '...' : q.content;
+    return '<div class="index-item" data-msg="' + msgIdx + '" onclick="scrollToMsg(' + msgIdx + ')"><span class="num">' + (++idx) + '</span><span>' + escHtml(text) + '</span></div>';
+  }).join('');
+  window._restoreCmd = data.restoreCmd;
+  setTimeout(() => {
+    const msgsEl = document.getElementById('messages');
+    if (!msgsEl) return;
+    msgsEl.addEventListener('scroll', function() {
+      var bar = document.getElementById('progressBar');
+      if (!bar) return;
+      var pct = msgsEl.scrollHeight > msgsEl.clientHeight ? (msgsEl.scrollTop / (msgsEl.scrollHeight - msgsEl.clientHeight)) * 100 : 0;
+      bar.style.width = pct + '%';
+    });
+    var observer = new IntersectionObserver(function(entries) {
+      for (var j = 0; j < entries.length; j++) {
+        if (entries[j].isIntersecting) {
+          var id = entries[j].target.id;
+          var msgIdx = parseInt(id.replace('msg-', ''));
+          document.querySelectorAll('.index-item').forEach(function(el) { el.classList.toggle('active', parseInt(el.dataset.msg) === msgIdx); });
+        }
+      }
+    }, { root: msgsEl, threshold: 0.5 });
+    document.querySelectorAll('.message').forEach(function(el) { observer.observe(el); });
+  }, 100);
+}
+
+function scrollToMsg(idx) {
+  var el = document.getElementById('msg-' + idx);
+  if (el) el.scrollIntoView({ behavior: 'smooth', block: 'center' });
+}
+
+function copyCmd() {
+  if (window._restoreCmd) { navigator.clipboard.writeText(window._restoreCmd); showToast('\u5DF2\u590D\u5236: ' + window._restoreCmd); }
+}
+
+function showToast(msg) {
+  var el = document.getElementById('toast');
+  el.textContent = msg;
+  el.classList.add('show');
+  setTimeout(function() { el.classList.remove('show'); }, 2000);
+}
+
+function getFilteredList() {
+  var q = document.getElementById('search').value.toLowerCase();
+  if (!q) return sessions;
+  return sessions.filter(function(s) { return s.firstQuestion.toLowerCase().includes(q) || s.projectName.toLowerCase().includes(q); });
+}
+
+document.getElementById('search').addEventListener('input', function() { renderSessionList(getFilteredList()); });
+
+function escHtml(s) {
+  if (!s) return '';
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
+function renderMarkdown(text) {
+  if (!text) return '';
+  var h = escHtml(text);
+  var BT = String.fromCharCode(96);
+  h = h.replace(new RegExp(BT + BT + BT + '(\\\\w*)\\\\n([\\\\s\\\\S]*?)' + BT + BT + BT, 'g'), function(m, lang, code) { return '<pre><code>' + highlightCode(code) + '</code></pre>'; });
+  h = h.replace(new RegExp(BT + '([^\\\\n]+?)' + BT, 'g'), '<code>$1</code>');
+  h = h.replace(/^### (.+)$/gm, '<h3>$1</h3>');
+  h = h.replace(/^## (.+)$/gm, '<h2>$1</h2>');
+  h = h.replace(/^# (.+)$/gm, '<h1>$1</h1>');
+  h = h.replace(/\\*\\*(.+?)\\*\\*/g, '<strong>$1</strong>');
+  h = h.replace(/\\*(.+?)\\*/g, '<em>$1</em>');
+  h = h.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g, '<a href="$2" target="_blank">$1</a>');
+  h = h.replace(/^&gt; (.+)$/gm, '<blockquote>$1</blockquote>');
+  h = h.replace(/^---$/gm, '<hr>');
+  h = h.replace(/^[-*] (.+)$/gm, '<li>$1</li>');
+  h = h.replace(/(<li>.*<\\/li>)/s, '<ul>$1</ul>');
+  h = h.replace(/^\\|(.+)\\|$/gm, function(m, content) {
+    var cells = content.split('|').map(function(c) { return c.trim(); });
+    if (cells.every(function(c) { return /^[-:]+$/.test(c); })) return '';
+    return '<tr>' + cells.map(function(c) { return '<td>' + c + '</td>'; }).join('') + '</tr>';
+  });
+  h = h.replace(/(<tr>.*<\\/tr>)/gs, '<table>$1</table>');
+  h = h.replace(/\\n\\n/g, '</p><p>');
+  h = '<p>' + h + '</p>';
+  h = h.replace(/<p><\\/p>/g, '');
+  h = h.replace(/<p>(<h[123]>)/g, '$1');
+  h = h.replace(/(<\\/h[123]>)<\\/p>/g, '$1');
+  h = h.replace(/<p>(<pre>)/g, '$1');
+  h = h.replace(/(<\\/pre>)<\\/p>/g, '$1');
+  h = h.replace(/<p>(<table>)/g, '$1');
+  h = h.replace(/(<\\/table>)<\\/p>/g, '$1');
+  h = h.replace(/<p>(<ul>)/g, '$1');
+  h = h.replace(/(<\\/ul>)<\\/p>/g, '$1');
+  h = h.replace(/<p>(<blockquote>)/g, '$1');
+  h = h.replace(/(<\\/blockquote>)<\\/p>/g, '$1');
+  h = h.replace(/<p>(<hr>)/g, '$1');
+  h = h.replace(/(<hr>)<\\/p>/g, '$1');
+  return h;
+}
+
+function highlightCode(code) {
+  var h = code;
+  h = h.replace(/(\\/\\/.*$)/gm, '<span class="cm">$1</span>');
+  h = h.replace(/(#.*$)/gm, '<span class="cm">$1</span>');
+  h = h.replace(/("(?:[^"\\\\\\\\]|\\\\\\\\.)*"|'(?:[^'\\\\\\\\]|\\\\\\\\.)*')/g, '<span class="str">$1</span>');
+  h = h.replace(/\\b(import|export|from|const|let|var|function|return|if|else|for|while|class|extends|new|async|await|try|catch|throw|switch|case|break|default|typeof|instanceof|void|null|undefined|true|false|def|self|print|raise|with|as|in|not|and|or|is|lambda|yield|assert|del|global|nonlocal|pass|elif|except|finally)\\b/g, '<span class="kw">$1</span>');
+  h = h.replace(/\\b(\\d+\\.?\\d*)\\b/g, '<span class="num">$1</span>');
+  return h;
+}
+
+loadSessions();`;
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>ccm sessions</title>
+<style>
+* { margin: 0; padding: 0; box-sizing: border-box; }
+html { scroll-behavior: smooth; }
+:root {
+  --td-brand-color: #0052D9;
+  --td-brand-color-hover: #266FE8;
+  --td-brand-color-light: #ECF2FE;
+  --td-success-color: #00A870;
+  --td-warning-color: #ED7B2F;
+  --td-error-color: #E34D59;
+  --td-gray-1: #F3F3F3;
+  --td-gray-2: #EEEEEE;
+  --td-gray-3: #E7E7E7;
+  --td-gray-4: #DCDCDC;
+  --td-gray-6: #A6A6A6;
+  --td-gray-8: #616161;
+  --td-gray-10: #1A1A1A;
+  --td-text-primary: #1A1A1A;
+  --td-text-secondary: #4A4A4A;
+  --td-text-placeholder: #A6A6A6;
+  --td-bg-page: #F3F3F3;
+  --td-bg-card: #FFFFFF;
+  --td-border-level-1: #E7E7E7;
+  --td-radius-small: 3px;
+  --td-radius-default: 6px;
+  --td-radius-large: 9px;
+  --td-shadow-1: 0 1px 4px rgba(0,0,0,.08);
+  --td-shadow-2: 0 4px 16px rgba(0,0,0,.10);
+}
+body {
+  font-family: -apple-system, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "WenQuanYi Micro Hei", sans-serif;
+  font-size: 14px; line-height: 1.6;
+  color: var(--td-text-primary); background: var(--td-bg-page);
+  height: 100vh; overflow: hidden;
+}
+::-webkit-scrollbar { width: 6px; height: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--td-gray-4); border-radius: 3px; }
+::-webkit-scrollbar-thumb:hover { background: var(--td-gray-6); }
+
+.app { display: grid; grid-template-columns: 280px 1fr 220px; height: 100vh; }
+
+/* \u2500\u2500\u2500 Sidebar \u2500\u2500\u2500 */
+.sidebar {
+  background: var(--td-bg-card);
+  border-right: 1px solid var(--td-border-level-1);
+  display: flex; flex-direction: column; overflow: hidden;
+}
+.sidebar-header {
+  padding: 16px; border-bottom: 1px solid var(--td-border-level-1);
+}
+.sidebar-header h2 {
+  font-size: 15px; font-weight: 600; margin-bottom: 10px;
+  color: var(--td-text-primary);
+}
+.sidebar-header input {
+  width: 100%; padding: 8px 12px;
+  border: 1px solid var(--td-border-level-1);
+  border-radius: var(--td-radius-default);
+  font-size: 13px; outline: none; color: var(--td-text-primary);
+  transition: border-color .15s, box-shadow .15s;
+}
+.sidebar-header input::placeholder { color: var(--td-text-placeholder); }
+.sidebar-header input:focus {
+  border-color: var(--td-brand-color);
+  box-shadow: 0 0 0 2px rgba(0,82,217,.12);
+}
+.session-list { flex: 1; overflow-y: auto; padding: 8px 0; }
+.session-item {
+  padding: 10px 16px; cursor: pointer;
+  transition: background .15s;
+  border-radius: 0;
+  border-left: 3px solid transparent;
+}
+.session-item:hover { background: var(--td-brand-color-light); }
+.session-item.active {
+  background: var(--td-brand-color-light);
+  border-left-color: var(--td-brand-color);
+}
+.session-item .time {
+  font-size: 12px; font-weight: 700; color: var(--td-brand-color);
+  text-transform: uppercase; letter-spacing: .06em;
+  font-variant-numeric: tabular-nums;
+}
+.session-item .question {
+  font-size: 13px;
+  margin-top: 4px;
+  color: var(--td-text-primary);
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+  line-height: 1.5;
+}
+
+/* \u2500\u2500\u2500 Progress bar \u2500\u2500\u2500 */
+.progress-bar {
+  position: fixed; top: 0; left: 0; height: 3px; width: 0;
+  background: linear-gradient(90deg, var(--td-brand-color), #66B2FF);
+  z-index: 100; transition: width .1s;
+}
+
+/* \u2500\u2500\u2500 Main \u2500\u2500\u2500 */
+.main { display: flex; flex-direction: column; overflow: hidden; }
+.main-header {
+  padding: 20px 24px;
+  border-bottom: 1px solid var(--td-border-level-1);
+  background: var(--td-bg-card);
+}
+.main-header h1 {
+  font-size: 16px; font-weight: 600; margin-bottom: 10px;
+  line-height: 1.5; color: var(--td-text-primary);
+}
+.main-header .meta {
+  display: flex; gap: 18px; font-size: 12px;
+  color: var(--td-text-placeholder); flex-wrap: wrap;
+}
+.main-header .meta span {
+  display: flex; align-items: center; gap: 5px;
+}
+.main-header .meta .meta-date {
+  text-transform: uppercase; letter-spacing: .06em;
+}
+.main-header .meta svg { opacity: .7; }
+.restore-bar {
+  margin-top: 14px; display: flex; align-items: center; gap: 10px;
+  background: var(--td-gray-1); padding: 10px 14px;
+  border-radius: var(--td-radius-default);
+  border: 1px solid var(--td-border-level-1);
+  font-family: "JetBrains Mono", "Fira Code", "SF Mono", Monaco, Consolas, monospace;
+  font-size: 13px;
+}
+.restore-bar code { flex: 1; color: var(--td-text-secondary); }
+.copy-btn {
+  padding: 5px 14px; background: var(--td-brand-color); color: #fff;
+  border: none; border-radius: var(--td-radius-small);
+  cursor: pointer; font-size: 12px; font-weight: 500; white-space: nowrap;
+  transition: background .15s;
+}
+.copy-btn:hover { background: var(--td-brand-color-hover); }
+
+/* \u2500\u2500\u2500 Messages \u2500\u2500\u2500 */
+.messages {
+  flex: 1; overflow-y: auto; padding: 24px 16px;
+  background: var(--td-bg-card);box-shadow: var(--td-shadow-1);
+}
+.message { margin-bottom: 20px; display: flex; gap: 10px; }
+.message.user { flex-direction: row-reverse; justify-content: flex-start; }
+.message .avatar {
+  width: 32px; height: 32px; border-radius: 50%;
+  display: flex; align-items: center; justify-content: center;
+  font-size: 13px; font-weight: 600; flex-shrink: 0;
+}
+.message.user .avatar {
+  background: var(--td-brand-color); color: #fff;
+}
+.message.ai .avatar {
+  background: #F6FFF9; color: var(--td-success-color);
+  border: 1px solid #A3DFC5;
+}
+.message .bubble {
+  max-width: 85%; padding: 12px 16px;
+  border-radius: var(--td-radius-large);
+  line-height: 1.7; font-size: 14px;
+}
+.message.user .bubble { background: var(--td-brand-color-light); color: var(--td-text-primary); }
+.message.ai .bubble { background-color: var(--ai-bubble, #f5f7fa);}
+.message .time {
+  font-size: 11px; color: var(--td-text-placeholder); margin-top: 6px;
+  font-variant-numeric: tabular-nums;
+}
+.message.user .time { text-align: right; }
+.message .model-tag {
+  font-size: 11px; color: var(--td-brand-color); margin-bottom: 6px;
+  font-weight: 500;
+}
+.message-count {
+  text-align: center; color: var(--td-text-placeholder);
+  font-size: 12px; padding: 20px;
+}
+
+/* \u2500\u2500\u2500 Bubble content \u2500\u2500\u2500 */
+.bubble h1, .bubble h2, .bubble h3 { margin: 16px 0 8px; font-weight: 600; color: var(--td-text-primary); }
+.bubble h1 { font-size: 17px; }
+.bubble h2 { font-size: 15px; }
+.bubble h3 { font-size: 14px; }
+.bubble p { margin-bottom: 10px; }
+.bubble p:last-child { margin-bottom: 0; }
+.bubble ul, .bubble ol { margin: 10px 0; padding-left: 22px; }
+.bubble li { margin-bottom: 5px; line-height: 1.6; }
+.bubble code {
+  background: rgba(175,184,193,.25); color: #C7254E;
+  padding: 2px 5px; border-radius: 3px;
+  font-family: "JetBrains Mono", "Fira Code", Consolas, monospace; font-size: .86em;
+}
+.bubble pre {
+  background: #F6F8FA; border: 1px solid #E1E4E8;
+  padding: 16px 18px; border-radius: var(--td-radius-default);
+  overflow-x: auto; margin: 12px 0;
+  font-size: 13px; line-height: 1.7;
+}
+.bubble pre code {
+  background: none; padding: 0; color: #24292E; font-size: 12.5px;
+  border-radius: 0;
+}
+.bubble blockquote {
+  border-left: 4px solid var(--td-brand-color);
+  background: var(--td-brand-color-light);
+  padding: 12px 16px; margin: 12px 0;
+  border-radius: 0 var(--td-radius-default) var(--td-radius-default) 0;
+  color: var(--td-text-secondary); font-size: 13.5px;
+}
+.bubble table { border-collapse: collapse; margin: 12px 0; width: 100%; font-size: 13px; }
+.bubble th, .bubble td { border: 1px solid var(--td-border-level-1); padding: 8px 12px; text-align: left; }
+.bubble th { background: var(--td-gray-1); font-weight: 600; color: var(--td-text-primary); }
+.bubble td { color: var(--td-text-secondary); }
+.bubble a { color: var(--td-brand-color); text-decoration: none; }
+.bubble a:hover { text-decoration: underline; }
+.bubble strong { font-weight: 600; color: var(--td-text-primary); }
+.bubble em { font-style: italic; color: var(--td-brand-color); }
+.bubble hr { border: none; border-top: 1px solid var(--td-border-level-1); margin: 16px 0; }
+
+/* GitHub Light syntax colors */
+.bubble pre .kw { color: #D73A49; font-weight: 600; }
+.bubble pre .str { color: #032F62; }
+.bubble pre .cm { color: #6A737D; font-style: italic; }
+.bubble pre .fn { color: #6F42C1; }
+.bubble pre .num { color: #005CC5; }
+.bubble pre .keyword { color: #D73A49; font-weight: 600; }
+.bubble pre .string { color: #032F62; }
+.bubble pre .comment { color: #6A737D; font-style: italic; }
+.bubble pre .number { color: #005CC5; }
+
+/* \u2500\u2500\u2500 Index panel \u2500\u2500\u2500 */
+.index {
+  background: var(--td-bg-card);
+  border-left: 1px solid var(--td-border-level-1);
+  display: flex; flex-direction: column; overflow: hidden;
+}
+.index-header {
+  padding: 14px 16px; border-bottom: 1px solid var(--td-border-level-1);
+  font-size: 16px; font-weight: 700; color: var(--td-text-primary);
+}
+.index-list { flex: 1; overflow-y: auto; padding: 8px; }
+.index-item {
+  padding: 8px 10px; font-size: 12px; cursor: pointer;
+  border-radius: var(--td-radius-small);
+  color: var(--td-text-secondary); line-height: 1.5;
+  transition: background .15s, color .15s;
+  display: flex; gap: 8px;
+}
+.index-item:hover { background: var(--td-brand-color-light); color: var(--td-text-primary); }
+.index-item.active {
+  background: var(--td-brand-color-light);
+  color: var(--td-brand-color); font-weight: 500;
+}
+.index-item .num {
+  color: var(--td-text-placeholder); flex-shrink: 0; min-width: 18px;
+  font-variant-numeric: tabular-nums;
+}
+
+/* \u2500\u2500\u2500 Empty state \u2500\u2500\u2500 */
+.empty {
+  display: flex; align-items: center; justify-content: center;
+  height: 100%; color: var(--td-text-placeholder); font-size: 15px;
+}
+.welcome { text-align: center; }
+.welcome h2 {
+  font-size: 20px; margin-bottom: 8px; color: var(--td-text-primary);
+  font-weight: 600;
+}
+.welcome p { font-size: 14px; color: var(--td-text-placeholder); }
+
+/* \u2500\u2500\u2500 Toast \u2500\u2500\u2500 */
+.toast {
+  position: fixed; bottom: 40px; left: 50%;
+  transform: translateX(-50%) translateY(8px);
+  background: var(--td-gray-10); color: #fff;
+  padding: 10px 24px; border-radius: var(--td-radius-large);
+  font-size: 13px; opacity: 0;
+  transition: opacity .25s, transform .25s;
+  pointer-events: none; z-index: 100;
+  box-shadow: var(--td-shadow-2);
+}
+.toast.show { opacity: 1; transform: translateX(-50%) translateY(0); }
+</style>
+</head>
+<body>
+<div class="progress-bar" id="progressBar"></div>
+<div class="app">
+  <div class="sidebar">
+    <div class="sidebar-header">
+      <h2>ccm sessions</h2>
+      <input type="text" id="search" placeholder="\u641C\u7D22\u4F1A\u8BDD...">
+    </div>
+    <div class="session-list" id="sessionList"></div>
+  </div>
+  <div class="main" id="main">
+    <div class="empty" id="emptyState">
+      <div class="welcome">
+        <h2>ccm sessions</h2>
+        <p>\u9009\u62E9\u5DE6\u4FA7\u4F1A\u8BDD\u67E5\u770B\u5BF9\u8BDD\u8BB0\u5F55</p>
+      </div>
+    </div>
+  </div>
+  <div class="index" id="indexPanel" style="display:none">
+    <div class="index-header">\u95EE\u9898\u7D22\u5F15</div>
+    <div class="index-list" id="indexList"></div>
+  </div>
+</div>
+<div class="toast" id="toast"></div>
+<script>${jsCode}</script>
+</body>
+</html>`;
+}
+
+// src/commands/sessions.ts
+var PAGE_SIZE = 10;
+function formatTime(ts) {
+  const d = new Date(ts);
+  const mm = String(d.getMonth() + 1).padStart(2, "0");
+  const dd = String(d.getDate()).padStart(2, "0");
+  const hh = String(d.getHours()).padStart(2, "0");
+  const mi = String(d.getMinutes()).padStart(2, "0");
+  return `${mm}-${dd} ${hh}:${mi}`;
+}
+function truncate(str, len) {
+  if (str.length <= len) return str;
+  return str.slice(0, len) + "...";
+}
+function printTable(sessions, page, selectedIndex) {
+  const start = page * PAGE_SIZE;
+  const end = Math.min(start + PAGE_SIZE, sessions.length);
+  const pageSessions = sessions.slice(start, end);
+  console.clear();
+  console.log();
+  console.log("  \x1B[1mccm sessions\x1B[0m  (\u2191\u2193 \u9009\u62E9 | Enter Web\u67E5\u770B | d \u5220\u9664 | D \u6E05\u7A7A\u5168\u90E8 | q \u9000\u51FA)");
+  console.log();
+  if (sessions.length === 0) {
+    console.log("  \u6682\u65E0\u4F1A\u8BDD\u8BB0\u5F55");
+    console.log();
+    return;
+  }
+  const totalW = process.stdout.columns || 80;
+  const timeW = 12;
+  const gap = 2;
+  const prefixW = 4;
+  const availW = totalW - prefixW - timeW - gap * 2;
+  let maxProjLen = 4;
+  for (const s of pageSessions) {
+    if (s.projectName.length > maxProjLen) maxProjLen = s.projectName.length;
+  }
+  const projW = maxProjLen + 2;
+  const questionW = Math.max(10, availW - projW);
+  console.log(
+    " ".repeat(prefixW) + "\x1B[2m" + "\u65F6\u95F4".padEnd(timeW) + " ".repeat(gap) + "\u9879\u76EE".padEnd(projW) + " ".repeat(gap) + "\u9996\u6761\u63D0\u95EE\x1B[0m"
+  );
+  console.log(" ".repeat(prefixW) + "\x1B[2m" + "\u2500".repeat(Math.min(totalW - prefixW, 80)) + "\x1B[0m");
+  for (let i = 0; i < pageSessions.length; i++) {
+    const s = pageSessions[i];
+    const globalIdx = start + i;
+    const isSelected = globalIdx === selectedIndex;
+    const prefix = isSelected ? "  \x1B[36m\u25B6 " : "    ";
+    const suffix = isSelected ? "\x1B[0m" : "";
+    const time = formatTime(s.timestamp);
+    const proj = truncate(s.projectName, projW);
+    const question = truncate(s.firstQuestion, questionW);
+    console.log(
+      prefix + time.padEnd(timeW) + " ".repeat(gap) + proj.padEnd(projW) + " ".repeat(gap) + question + suffix
+    );
+  }
+  const totalPages = Math.ceil(sessions.length / PAGE_SIZE);
+  if (totalPages > 1) {
+    console.log();
+    console.log(
+      `\x1B[2m  \u7B2C ${page + 1}/${totalPages} \u9875 (\u5171 ${sessions.length} \u4E2A\u4F1A\u8BDD, \u2190 \u2192 \u7FFB\u9875)\x1B[0m`
+    );
+  }
+}
+async function confirmPrompt(msg) {
+  process.stdout.write(`
+  ${msg} (y/N) `);
+  return new Promise((resolve) => {
+    process.stdin.once("data", (data) => {
+      resolve(data.toString().trim().toLowerCase() === "y");
+    });
+  });
+}
+async function cmdSessions(args) {
+  cleanupOldTrash();
+  if (args.purge) {
+    const trash = getTrashSessions();
+    if (trash.length === 0) {
+      console.log("\n  \u56DE\u6536\u7AD9\u4E3A\u7A7A\n");
+      return;
+    }
+    console.log(`
+  \u56DE\u6536\u7AD9\u4E2D\u6709 ${trash.length} \u4E2A\u4F1A\u8BDD`);
+    const confirmed = await confirmPrompt("\x1B[31m\u786E\u8BA4\u6E05\u7A7A\u56DE\u6536\u7AD9\uFF1F\u6B64\u64CD\u4F5C\u4E0D\u53EF\u6062\u590D\uFF01\x1B[0m");
+    if (confirmed) {
+      purgeTrash();
+      ok("\u56DE\u6536\u7AD9\u5DF2\u6E05\u7A7A");
+    }
+    console.log();
+    return;
+  }
+  if (args.restore !== void 0) {
+    if (args.restore === "") {
+      const trash = getTrashSessions();
+      if (trash.length === 0) {
+        console.log("\n  \u56DE\u6536\u7AD9\u4E3A\u7A7A\n");
+        return;
+      }
+      const latest = trash[0];
+      const confirmed = await confirmPrompt(`\u6062\u590D\u4F1A\u8BDD "${latest.sessionId.slice(0, 8)}..."\uFF1F`);
+      if (confirmed) {
+        restoreSession(latest.sessionId);
+        ok("\u4F1A\u8BDD\u5DF2\u6062\u590D");
+      }
+    } else {
+      const success = restoreSession(args.restore);
+      if (success) {
+        ok("\u4F1A\u8BDD\u5DF2\u6062\u590D");
+      } else {
+        err(`\u672A\u627E\u5230\u4F1A\u8BDD ${args.restore}`);
+      }
+    }
+    console.log();
+    return;
+  }
+  if (args.web) {
+    await startSessionServer();
+    return;
+  }
+  const sessions = getSessionsList();
+  if (sessions.length === 0) {
+    console.log("\n  \u6682\u65E0\u4F1A\u8BDD\u8BB0\u5F55\n");
+    return;
+  }
+  let selectedIndex = 0;
+  let page = 0;
+  const totalPages = Math.ceil(sessions.length / PAGE_SIZE);
+  process.stdin.setRawMode?.(true);
+  process.stdin.resume();
+  process.stdin.setEncoding("utf-8");
+  const cleanup = () => {
+    process.stdin.setRawMode?.(false);
+    process.stdin.pause();
+  };
+  printTable(sessions, page, selectedIndex);
+  return new Promise((resolve) => {
+    process.stdin.on("data", async (key) => {
+      if (key === "" || key === "q") {
+        cleanup();
+        console.log();
+        resolve();
+        return;
+      }
+      if (key === "\x1B[A") {
+        if (selectedIndex > 0) {
+          selectedIndex--;
+          if (selectedIndex < page * PAGE_SIZE) {
+            page = Math.floor(selectedIndex / PAGE_SIZE);
+          }
+          printTable(sessions, page, selectedIndex);
+        }
+        return;
+      }
+      if (key === "\x1B[B") {
+        if (selectedIndex < sessions.length - 1) {
+          selectedIndex++;
+          if (selectedIndex >= (page + 1) * PAGE_SIZE) {
+            page = Math.floor(selectedIndex / PAGE_SIZE);
+          }
+          printTable(sessions, page, selectedIndex);
+        }
+        return;
+      }
+      if (key === "\x1B[D") {
+        if (page > 0) {
+          page--;
+          selectedIndex = page * PAGE_SIZE;
+          printTable(sessions, page, selectedIndex);
+        }
+        return;
+      }
+      if (key === "\x1B[C") {
+        if (page < totalPages - 1) {
+          page++;
+          selectedIndex = page * PAGE_SIZE;
+          printTable(sessions, page, selectedIndex);
+        }
+        return;
+      }
+      if (key === "\r" || key === "\n") {
+        cleanup();
+        const session = sessions[selectedIndex];
+        if (session) {
+          console.log();
+          await startSessionServer();
+        }
+        resolve();
+        return;
+      }
+      if (key === "d") {
+        cleanup();
+        const session = sessions[selectedIndex];
+        if (session) {
+          const confirmed = await confirmPrompt(`\u786E\u8BA4\u5220\u9664 "${truncate(session.firstQuestion, 30)}"\uFF1F(\u79FB\u5165\u56DE\u6536\u7AD9)`);
+          if (confirmed) {
+            deleteSession(session.sessionId);
+            sessions.splice(selectedIndex, 1);
+            if (selectedIndex >= sessions.length) selectedIndex = Math.max(0, sessions.length - 1);
+            ok("\u5DF2\u79FB\u5165\u56DE\u6536\u7AD9 (ccm sessions --restore \u6062\u590D)");
+          }
+        }
+        process.stdin.setRawMode?.(true);
+        process.stdin.resume();
+        printTable(sessions, page, selectedIndex);
+        return;
+      }
+      if (key === "D") {
+        cleanup();
+        const confirmed = await confirmPrompt("\x1B[33m\u786E\u8BA4\u6E05\u7A7A\u5168\u90E8\u4F1A\u8BDD\uFF1F(\u79FB\u5165\u56DE\u6536\u7AD9\uFF0C30\u5929\u540E\u81EA\u52A8\u6E05\u7406)\x1B[0m");
+        if (confirmed) {
+          deleteAllSessions();
+          sessions.length = 0;
+          ok("\u5168\u90E8\u4F1A\u8BDD\u5DF2\u79FB\u5165\u56DE\u6536\u7AD9");
+        }
+        process.stdin.setRawMode?.(true);
+        process.stdin.resume();
+        printTable(sessions, page, selectedIndex);
+        return;
+      }
+    });
+  });
+}
+
 // src/cli.ts
 var pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 var VERSION = pkg.version;
@@ -824,7 +1913,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "balance",
   "bal",
   "config",
-  "completions"
+  "completions",
+  "sessions"
 ]);
 function printHelp() {
   console.log(`
@@ -843,6 +1933,10 @@ Commands:
   balance [name]    Query model balance/credits
   config <name>     Show profile environment variables
   completions       Print shell completion script
+  sessions          Browse and manage session history
+  sessions --web    Open session viewer in browser
+  sessions --restore [id] Restore session from trash
+  sessions --purge  Empty the trash permanently
 
 Options:
   -v, --version     Show version
@@ -853,13 +1947,14 @@ Shortcuts:
 `);
 }
 function parseArgs(argv) {
-  const args = { _: [] };
+  const args = { _: [], extra: [] };
   let i = 0;
   while (i < argv.length) {
     const arg = argv[i];
     if (arg === "--all") {
       args.all = true;
     } else if (arg.startsWith("-")) {
+      args.extra.push(arg);
     } else {
       args._.push(arg);
     }
@@ -895,14 +1990,14 @@ async function main() {
   const firstArg = rawArgs[0];
   if (firstArg && !KNOWN_COMMANDS.has(firstArg) && !firstArg.startsWith("-")) {
     if (profileExists(firstArg)) {
-      cmdLaunch({ name: firstArg });
+      cmdLaunch({ name: firstArg, extraArgs: rawArgs.slice(1) });
       return;
     }
   }
   const { command, args } = parseArgs(rawArgs);
   switch (command) {
     case "_launch":
-      cmdLaunch({ name: args.name });
+      cmdLaunch({ name: args.name, extraArgs: args.extra || [] });
       break;
     case "_register":
       cmdRegister({ name: args.name, pid: args.pid, tty: args.tty });
@@ -942,6 +2037,16 @@ async function main() {
     case "completions":
       cmdCompletions({ shell: args.shell });
       break;
+    case "sessions": {
+      const restoreIdx = rawArgs.indexOf("--restore");
+      const restoreId = restoreIdx >= 0 ? rawArgs[restoreIdx + 1] || "" : void 0;
+      await cmdSessions({
+        web: rawArgs.includes("--web"),
+        restore: restoreIdx >= 0 ? restoreId : void 0,
+        purge: rawArgs.includes("--purge")
+      });
+      break;
+    }
     default:
       console.error(`Unknown command: ${command}`);
       printHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeandrew94/ccm",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Claude Code Model Manager - switch between AI models per terminal",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "bin",
+    "assets",
     "README.md",
     "README.zh.md",
     "LICENSE"