claude-starter 1.1.1 → 1.3.0

package/README.md

@@ -1,6 +1,7 @@
 <p align="center">
   <img src="https://img.shields.io/badge/%F0%9F%9A%80-Claude_Starter-7aa2f7?style=for-the-badge&labelColor=1a1b26" alt="Claude Starter" />
   <br/>
+  <img src="https://img.shields.io/npm/v/claude-starter?style=flat-square&color=f7768e&logo=npm" alt="npm" />
   <img src="https://img.shields.io/badge/node-%3E%3D18-9ece6a?style=flat-square&logo=node.js&logoColor=white" alt="Node.js" />
   <img src="https://img.shields.io/badge/license-MIT-bb9af7?style=flat-square" alt="MIT License" />
   <img src="https://img.shields.io/github/v/release/Bojun-Vvibe/claude-starter?style=flat-square&color=7dcfff" alt="Release" />
@@ -15,7 +16,7 @@
 </p>
 
 <p align="center">
-  <code>git clone</code>&nbsp;&nbsp;→&nbsp;&nbsp;<code>npm link</code>&nbsp;&nbsp;→&nbsp;&nbsp;<code>claude-starter</code>
+  <code>npm install -g claude-starter</code>&nbsp;&nbsp;→&nbsp;&nbsp;<code>claude-starter</code>
 </p>
 
 <p align="center">
@@ -73,11 +74,19 @@ claude-starter
 | 📋 | **对话预览** | 右侧面板展示完整元数据和对话历史 |
 | 🔀 | **多种排序** | 时间 / 大小 / 消息数 / 项目 |
 | 📎 | **复制 ID** | `c` 一键复制到剪贴板 |
+| 🔒 | **权限模式** | `m` 设置权限模式，`d` 一键 danger 模式恢复 |
+| 🗑️ | **删除会话** | `x` 删除不需要的会话 |
 | 🧠 | **智能 CLI** | 自动检测 `mai-claude` / `claude` |
-| 🔒 | **完全本地** | 不联网，不上传，不追踪 |
+| 🔐 | **完全本地** | 不联网，不上传，不追踪 |
 
 ## 安装
 
+```bash
+npm install -g claude-starter
+```
+
+或者从源码安装：
+
 ```bash
 git clone https://github.com/Bojun-Vvibe/claude-starter.git
 cd claude-starter
@@ -87,6 +96,16 @@ npm link
 
 然后运行 `claude-starter`，就这么简单。
 
+## CLI 参数
+
+```bash
+claude-starter              # 启动交互式 TUI
+claude-starter --list [N]   # 打印最近 N 个会话（默认 30）
+claude-starter --version    # 显示版本号
+claude-starter --update     # 检查并更新到最新版本
+claude-starter --help       # 显示帮助信息
+```
+
 ## 快捷键
 
 | 按键 | 功能 |
@@ -94,12 +113,15 @@ npm link
 | `↑` `↓` | 上下导航 |
 | `Enter` | 新建 / 恢复对话 |
 | `n` | 直接新建 |
+| `d` | Danger 模式恢复（bypassPermissions） |
+| `m` | 权限模式选择器 |
 | `/` | 搜索 |
 | `Backspace` | 删除搜索字符，删空自动退出 |
 | `Esc` | 清空搜索 |
 | `p` | 按项目过滤 |
-| `s` | 切换排序 |
+| `s` | 切换排序（时间/大小/消息数/项目） |
 | `c` | 复制 Session ID |
+| `x` / `Delete` | 删除会话 |
 | `Home` / `End` | 跳到顶 / 底 |
 | `Ctrl-D` / `Ctrl-U` | 翻页 |
 | `q` / `Ctrl-C` | 退出 |
@@ -151,17 +173,25 @@ Searches across **everything** — project names, Git branches, conversation con
 |---|---|---|
 | 🎨 | **Beautiful TUI** | Tokyo Night color scheme, split-pane layout, feels native in your terminal |
 | ✨ | **New Session** | Launch a fresh conversation in one keystroke |
-| 🔍 | **Instant Search** | Fuzzy search across everything, no Enter needed |
+| 🔍 | **Instant Search** | Fuzzy search across everything |
 | 📂 | **Project Filter** | Press `p` to filter by project |
 | ⚡ | **One-Key Resume** | Arrow, Enter, you're back in the conversation |
 | 📋 | **Session Preview** | Full metadata + conversation history in the right panel |
 | 🔀 | **Sort Modes** | Sort by time, size, messages, or project |
 | 📎 | **Copy ID** | Press `c` to copy session ID |
+| 🔒 | **Permission Modes** | Press `m` to configure, `d` for quick danger-mode resume |
+| 🗑️ | **Delete Sessions** | Press `x` to remove unwanted sessions |
 | 🧠 | **Smart CLI** | Auto-detects `mai-claude` vs `claude` |
-| 🔒 | **100% Local** | No network, no telemetry, no data leaves your machine |
+| 🔐 | **100% Local** | No network, no telemetry, no data leaves your machine |
 
 ## Install
 
+```bash
+npm install -g claude-starter
+```
+
+Or install from source:
+
 ```bash
 git clone https://github.com/Bojun-Vvibe/claude-starter.git
 cd claude-starter
@@ -175,6 +205,16 @@ Then run:
 claude-starter
 ```
 
+## CLI Options
+
+```bash
+claude-starter              # Launch interactive TUI
+claude-starter --list [N]   # Print latest N sessions (default: 30)
+claude-starter --version    # Show version
+claude-starter --update     # Update to the latest version
+claude-starter --help       # Show help
+```
+
 ## Keyboard Shortcuts
 
 | Key | Action |
@@ -182,12 +222,15 @@ claude-starter
 | `↑` `↓` | Navigate sessions |
 | `Enter` | Start new / resume selected session |
 | `n` | New session |
+| `d` | Resume with bypassPermissions (danger mode) |
+| `m` | Permission mode picker |
 | `/` | Search |
 | `Backspace` | Edit search, auto-exit when empty |
 | `Esc` | Clear filter |
 | `p` | Filter by project |
-| `s` | Cycle sort mode |
+| `s` | Cycle sort mode (time/size/messages/project) |
 | `c` | Copy session ID |
+| `x` / `Delete` | Delete session |
 | `Home` / `End` | Jump to first / last |
 | `Ctrl-D` / `Ctrl-U` | Page down / up |
 | `q` / `Ctrl-C` | Quit |

package/index.js

@@ -9,6 +9,8 @@
  *   claude-starter            # Launch interactive TUI
  *   claude-starter --list     # Print sessions as a table (no TUI)
  *   claude-starter --list N   # Print the latest N sessions
+ *   claude-starter --version  # Show version
+ *   claude-starter --update   # Update to the latest version
  *
  * Keyboard shortcuts (TUI mode):
  *   ↑/↓           Navigate sessions
@@ -18,9 +20,12 @@
  *   p              Filter by project (popup)
  *   s              Cycle sort: time → size → messages → project
  *   n              Start new session
+ *   d              Resume with bypassPermissions (danger mode)
+ *   m              Permission mode picker
  *   Home / End     Jump to top / bottom
  *   Ctrl-D/U       Page down / up
  *   c              Copy session ID to clipboard
+ *   x / Delete     Delete selected session
  *   q / Ctrl-C     Quit
  */
 
@@ -32,37 +37,72 @@ const os = require('os');
 
 // ─── CLI Detection ──────────────────────────────────────────────────────────
 // Detect whether `mai-claude` is available (binary, alias, or function).
-// We check inside an interactive shell so aliases defined in .bashrc/.zshrc
-// are visible.  Falls back to plain `claude`.
+// First checks PATH directly, then sources shell config non-interactively
+// to resolve aliases.  Falls back to plain `claude`.
+//
+// NOTE: We deliberately avoid `shell -i` (interactive mode) because it
+// triggers SIGTTOU in terminals like Warp that strictly manage TTY process
+// groups, causing `suspended (tty output)`.
 //
 // Returns { name, cmd } where:
 //   name = display label ("mai-claude" or "claude")
 //   cmd  = the actual command string to spawn (resolves aliases)
 
 function detectCLI() {
+  // Strategy:
+  // 1. First try non-interactive lookup (safe for all terminals including Warp)
+  // 2. Only fall back to interactive shell if needed for alias resolution
+  //
+  // IMPORTANT: avoid `shell -i` (interactive mode) — it can trigger SIGTTOU
+  // in terminals like Warp that strictly manage TTY process groups, causing
+  // the process to be suspended with "suspended (tty output)".
+
   const shell = process.env.SHELL || '/bin/sh';
+
+  // 1) Non-interactive: check if mai-claude exists as a binary on PATH
   try {
-    const raw = execSync(`${shell} -ic "command -v mai-claude" 2>/dev/null`, {
+    const binPath = execSync('command -v mai-claude 2>/dev/null', {
       stdio: ['pipe', 'pipe', 'pipe'],
       timeout: 3000,
+      shell: true,
     }).toString().trim();
+    if (binPath) {
+      return { name: 'mai-claude', cmd: 'mai-claude' };
+    }
+  } catch { /* not found as binary, continue */ }
 
-    // Interactive shells may print extra lines (e.g. "Restored session: …").
-    // The relevant output is the last line(s) containing the alias or path.
-    const lines = raw.split('\n');
-    const aliasLine = lines.find(l => l.startsWith('alias ')) || lines[lines.length - 1];
-
-    // `command -v` for an alias returns: alias mai-claude='actual command'
-    // Extract the real command from inside the quotes if it's an alias.
-    const aliasMatch = aliasLine.match(/^alias [^=]+=(?:'(.+)'|"(.+)")$/s);
-    if (aliasMatch) {
-      return { name: 'mai-claude', cmd: aliasMatch[1] || aliasMatch[2] };
+  // 2) Source shell config non-interactively to resolve aliases/functions.
+  //    This avoids `-i` which would try to claim the TTY and risk SIGTTOU.
+  try {
+    const isZsh = shell.endsWith('/zsh');
+    const rcFile = isZsh
+      ? path.join(os.homedir(), '.zshrc')
+      : path.join(os.homedir(), '.bashrc');
+
+    if (fs.existsSync(rcFile)) {
+      const raw = execSync(
+        `${shell} -c 'source "${rcFile}" 2>/dev/null; command -v mai-claude 2>/dev/null'`,
+        {
+          stdio: ['pipe', 'pipe', 'pipe'],
+          timeout: 3000,
+          env: { ...process.env, PS1: '', PROMPT: '', NO_TTY: '1' },
+        },
+      ).toString().trim();
+
+      if (raw) {
+        const lines = raw.split('\n');
+        const aliasLine = lines.find(l => l.startsWith('alias ')) || lines[lines.length - 1];
+
+        const aliasMatch = aliasLine.match(/^alias [^=]+=(?:'(.+)'|"(.+)")$/s);
+        if (aliasMatch) {
+          return { name: 'mai-claude', cmd: aliasMatch[1] || aliasMatch[2] };
+        }
+        return { name: 'mai-claude', cmd: 'mai-claude' };
+      }
     }
-    // Otherwise it's a binary/function path — use the name directly
-    return { name: 'mai-claude', cmd: 'mai-claude' };
-  } catch {
-    return { name: 'claude', cmd: 'claude' };
-  }
+  } catch { /* alias resolution failed, fall back to claude */ }
+
+  return { name: 'claude', cmd: 'claude' };
 }
 
 const CLI = detectCLI();
@@ -76,15 +116,86 @@ const PROJECT_COLORS = [
 // ─── Paths ───────────────────────────────────────────────────────────────────
 const CLAUDE_DIR = path.join(os.homedir(), '.claude');
 const PROJECTS_DIR = path.join(CLAUDE_DIR, 'projects');
+const META_FILE = path.join(CLAUDE_DIR, 'claude-starter-meta.json');
+
+// ─── Session Meta ────────────────────────────────────────────────────
+// Stores user-defined metadata for sessions in a simple JSON file.
+
+function loadMeta() {
+  try {
+    if (fs.existsSync(META_FILE)) {
+      return JSON.parse(fs.readFileSync(META_FILE, 'utf-8'));
+    }
+  } catch (e) { /* corrupt file, start fresh */ }
+  return { sessions: {} };
+}
+
+const PERMISSION_MODES = ['default', 'bypassPermissions', 'acceptEdits', 'dontAsk', 'plan', 'auto'];
+
+function saveMeta(meta) {
+  try {
+    fs.writeFileSync(META_FILE, JSON.stringify(meta, null, 2), 'utf-8');
+  } catch (e) { /* silently fail */ }
+}
+
+function getSessionMeta(meta, sessionId) {
+  return meta.sessions[sessionId] || {};
+}
+
+function getEffectivePermissionMode(meta, session) {
+  // Priority: per-session override > session's original mode from JSONL > global default
+  const sm = meta.sessions[session.sessionId];
+  if (sm && sm.permissionMode) return sm.permissionMode;
+  if (session.permissionMode) return session.permissionMode;
+  if (meta.defaultPermissionMode) return meta.defaultPermissionMode;
+  return '';
+}
+
+function setSessionPermissionMode(meta, sessionId, mode) {
+  if (!meta.sessions[sessionId]) meta.sessions[sessionId] = {};
+  meta.sessions[sessionId].permissionMode = mode || undefined;
+  if (!mode) delete meta.sessions[sessionId].permissionMode;
+  saveMeta(meta);
+}
+
+function setGlobalPermissionMode(meta, mode) {
+  meta.defaultPermissionMode = mode || undefined;
+  if (!mode) delete meta.defaultPermissionMode;
+  saveMeta(meta);
+}
+
 
 // ─── Data Layer ──────────────────────────────────────────────────────────────
 
 function getProjectDisplayName(dirName) {
-  return dirName
-    .replace(/-Users-[^-]+-Desktop-MSProject-/, '')
-    .replace(/-Users-[^-]+-Desktop-/, '')
-    .replace(/-Users-[^-]+/, '~')
-    .replace(/^-/, '') || '~';
+  // Claude stores projects as path with `-` separators, e.g.:
+  //   -Users-bob-Desktop-MSProject-my-app
+  //   -Users-bob-Projects-Router-Maestro
+  //   -Users-bob-Desktop-GraphConnector
+  //   -Users-bob
+  //
+  // Strategy: strip the user home prefix, then take the last meaningful path segment.
+  // This gives clean names like "my-app", "Router-Maestro", "GraphConnector".
+
+  // Remove leading -Users-<username> prefix
+  let name = dirName.replace(/^-Users-[^-]+/, '');
+
+  // If nothing left, it was just the home dir
+  if (!name || name === '-') return '~';
+
+  // Remove leading dash
+  name = name.replace(/^-/, '');
+
+  // Get the last path segment (split by common directory markers)
+  // e.g. "Desktop-MSProject-my-app" → "my-app"
+  //      "Desktop-GraphConnector" → "GraphConnector"
+  //      "Projects-Router-Maestro" → "Router-Maestro"
+  const knownPrefixes = /^(Desktop|Documents|Projects|Downloads|dev|src|code|repos|work|home)(?:-|$)/i;
+  while (knownPrefixes.test(name)) {
+    name = name.replace(/^[^-]+-?/, '');
+  }
+
+  return name || dirName.split('-').pop() || '~';
 }
 
 function loadSessionQuick(filePath, projectName) {
@@ -107,9 +218,10 @@ function loadSessionQuick(filePath, projectName) {
   const tailStr = tailBuf.toString('utf-8');
 
   let firstTs = null, lastTs = null;
-  let version = '', gitBranch = '', cwd = '';
+  let version = '', gitBranch = '', cwd = '', permissionMode = '';
   let firstUserMsg = '';
   let userMsgCount = 0;
+  let customTitle = '';
 
   const headLines = headStr.split('\n').filter(Boolean);
   for (const line of headLines) {
@@ -121,6 +233,8 @@ function loadSessionQuick(filePath, projectName) {
       if (!version && d.version) version = d.version;
       if (!gitBranch && d.gitBranch) gitBranch = d.gitBranch;
       if (!cwd && d.cwd) cwd = d.cwd;
+      if (!permissionMode && d.permissionMode) permissionMode = d.permissionMode;
+      if (d.type === 'custom-title' && d.customTitle) customTitle = d.customTitle;
       if (d.type === 'user') {
         userMsgCount++;
         if (!firstUserMsg) firstUserMsg = extractUserText(d);
@@ -135,6 +249,7 @@ function loadSessionQuick(filePath, projectName) {
         const d = JSON.parse(line);
         if (d.timestamp) lastTs = d.timestamp;
         if (d.type === 'user') userMsgCount++;
+        if (d.type === 'custom-title' && d.customTitle) customTitle = d.customTitle;
       } catch (e) { /* partial line */ }
     }
   }
@@ -157,6 +272,7 @@ function loadSessionQuick(filePath, projectName) {
   return {
     sessionId, project: projectName,
     topic: topic || '(no user messages)',
+    customTitle, permissionMode,
     firstTs, lastTs, version, gitBranch, cwd,
     fileSize: stat.size, duration: durationStr,
     estimatedMessages, filePath, _detailLoaded: false,
@@ -189,6 +305,7 @@ function loadSessionDetail(session) {
   for (const line of lines) {
     try {
       const d = JSON.parse(line);
+      if (d.type === 'custom-title' && d.customTitle) session.customTitle = d.customTitle;
       if (d.type === 'user') {
         totalMessages++;
         const text = extractUserText(d);
@@ -242,7 +359,11 @@ function loadAllSessions() {
     for (const file of files) {
       try {
         const session = loadSessionQuick(path.join(projPath, file), projectName);
-        if (session.firstTs) sessions.push(session);
+        // Skip sessions without timestamps, without real user messages, or warmup sessions
+        if (session.firstTs
+            && session.topic !== '(no user messages)'
+            && !/^warmup$/i.test(session.topic.trim())
+        ) sessions.push(session);
       } catch (e) { /* skip */ }
     }
   }
@@ -312,6 +433,7 @@ function runListMode(limit) {
 
 function createApp() {
   const allSessions = loadAllSessions();
+  const meta = loadMeta();
   let filteredSessions = [...allSessions];
   let selectedIndex = -1;  // -1 = "New Session", 0+ = session index
   let filterText = '';
@@ -324,12 +446,17 @@ function createApp() {
 
   // ─── Screen ────────────────────────────────────────────────────────────
   const screen = blessed.screen({
-    smartCSR: true,
+    smartCSR: false,
+    fastCSR: false,
     title: 'Claude Starter',
     fullUnicode: true,
     autoPadding: true,
+    dockBorders: true,
   });
 
+  // Force screen-level fill color so no terminal bg leaks through
+  screen.style = { bg: 234 };  // 234 = xterm color closest to #1a1b26
+
   // ─── Header ────────────────────────────────────────────────────────────
   const header = blessed.box({
     parent: screen, top: 0, left: 0, width: '100%', height: 3,
@@ -337,17 +464,20 @@ function createApp() {
   });
 
   function updateHeader() {
-    const title = '{bold}{#7aa2f7-fg}🚀 Claude Starter{/}';
+    const title = '{bold}{#7aa2f7-fg}Claude Starter{/}';
     const count = `{#9ece6a-fg}${filteredSessions.length}{/}{#565f89-fg}/${allSessions.length} sessions{/}`;
     const proj = `{#bb9af7-fg}${uniqueProjects.length}{/}{#565f89-fg} projects{/}`;
-    const sort = `{#73daca-fg}↕${sortMode}{/}`;
+    const sort = `{#73daca-fg}[${sortMode}]{/}`;
     const search = isSearchMode
       ? `{#e0af68-fg}/ ${filterText}▌{/}`
       : (filterText ? `{#e0af68-fg}/ ${filterText}{/}` : '');
-    header.setContent(`\n ${title} {#414868-fg}│{/} ${count} {#414868-fg}│{/} ${proj} {#414868-fg}│{/} ${sort}${search ? ` {#414868-fg}│{/} ${search}` : ''}`);
+    let parts = [title, count, proj];
+    parts.push(sort);
+    if (search) parts.push(search);
+    header.setContent(`\n ${parts.join(' {#414868-fg}│{/} ')}`);
   }
 
-  blessed.line({ parent: screen, top: 3, left: 0, width: '100%', orientation: 'horizontal', style: { fg: '#414868' } });
+  blessed.line({ parent: screen, top: 3, left: 0, width: '100%', orientation: 'horizontal', style: { fg: '#414868', bg: '#1a1b26' } });
 
   // ─── Left Panel: blessed.list for correct scroll tracking ──────────────
   const listPanel = blessed.list({
@@ -368,7 +498,7 @@ function createApp() {
     interactive: true,
   });
 
-  blessed.line({ parent: screen, top: 4, left: '50%', height: '100%-7', orientation: 'vertical', style: { fg: '#414868' } });
+  blessed.line({ parent: screen, top: 4, left: '50%', height: '100%-7', orientation: 'vertical', style: { fg: '#414868', bg: '#1a1b26' } });
 
   // ─── Right Panel ───────────────────────────────────────────────────────
   const detailPanel = blessed.box({
@@ -380,7 +510,7 @@ function createApp() {
     mouse: true,
   });
 
-  blessed.line({ parent: screen, bottom: 2, left: 0, width: '100%', orientation: 'horizontal', style: { fg: '#414868' } });
+  blessed.line({ parent: screen, bottom: 2, left: 0, width: '100%', orientation: 'horizontal', style: { fg: '#414868', bg: '#1a1b26' } });
 
   // ─── Footer ────────────────────────────────────────────────────────────
   const footer = blessed.box({
@@ -390,13 +520,15 @@ function createApp() {
 
   function updateFooter() {
     const keys = [
-      '{#7aa2f7-fg}{bold}↵{/} {#565f89-fg}Start/Resume{/}',
       '{#7aa2f7-fg}{bold}n{/} {#565f89-fg}New{/}',
+      '{#7aa2f7-fg}{bold}↵{/} {#565f89-fg}Resume{/}',
+      '{#7aa2f7-fg}{bold}m{/} {#565f89-fg}Mode{/}',
+      '{#f7768e-fg}{bold}d{/} {#565f89-fg}Danger{/}',
       '{#7aa2f7-fg}{bold}/{/} {#565f89-fg}Search{/}',
-      '{#7aa2f7-fg}{bold}↑/↓{/} {#565f89-fg}Nav{/}',
       '{#7aa2f7-fg}{bold}p{/} {#565f89-fg}Project{/}',
       '{#7aa2f7-fg}{bold}s{/} {#565f89-fg}Sort{/}',
       '{#7aa2f7-fg}{bold}c{/} {#565f89-fg}Copy ID{/}',
+      '{#f7768e-fg}{bold}x{/} {#565f89-fg}Delete{/}',
       '{#7aa2f7-fg}{bold}q{/} {#565f89-fg}Quit{/}',
     ];
     footer.setContent(`\n ${keys.join(' {#414868-fg}│{/} ')}`);
@@ -420,7 +552,7 @@ function createApp() {
       const branch = session.gitBranch
         ? `{#73daca-fg}${session.gitBranch.substring(0, 25)}{/}`
         : '';
-      const dur = session.duration ? `{#565f89-fg}⏱${session.duration}{/}` : '';
+      const dur = session.duration ? `{#565f89-fg}${session.duration}{/}` : '';
 
       // Compose a multi-line string for each list item.
       // blessed.list renders each item as a single row, so we pack info densely.
@@ -441,23 +573,32 @@ function createApp() {
 
   // ─── Populate list ─────────────────────────────────────────────────────
   // Index 0 = "New Session", index 1+ = sessions
-  const NEW_SESSION_LABEL = ' {#9ece6a-fg}{bold}✨ New Conversation{/}';
+  const NEW_SESSION_LABEL = ' {#9ece6a-fg}{bold}+ New Conversation{/}';
 
   function refreshList() {
     const listW = Math.floor((screen.width || 100) / 2) - 2;
 
     const sessionItems = filteredSessions.map((session) => {
       const color = getProjectColor(session.project, projectColorMap);
-      const proj = `{${color}-fg}${session.project.substring(0, 13).padEnd(13)}{/}`;
+      const eMode = getEffectivePermissionMode(meta, session);
+      const modeIcon = (eMode === 'bypassPermissions') ? '{#f7768e-fg}!{/}' : ' ';
+      const proj = `{${color}-fg}${session.project.substring(0, 12).padEnd(12)}{/}`;
       const time = `{#e0af68-fg}${formatTimestamp(session.lastTs).padEnd(16)}{/}`;
-      const msgs = `{#7aa2f7-fg}${String(session.estimatedMessages).padStart(4)}{/}{#565f89-fg}m{/}`;
 
-      const fixedLen = 13 + 1 + 16 + 1 + 5 + 2 + 3;
-      const topicMaxLen = Math.max(15, listW - fixedLen);
-      let topic = session.topic;
+      const fixedLen = 1 + 12 + 1 + 16 + 1 + 3;
+      const topicMaxLen = Math.max(10, listW - fixedLen);
+      let topic = session.customTitle || session.topic;
+
       if (topic.length > topicMaxLen) topic = topic.substring(0, topicMaxLen) + '…';
 
-      return ` ${proj} ${time} ${msgs} {#a9b1d6-fg}${esc(topic)}{/}`;
+      let label = `${modeIcon}${proj} ${time} `;
+      if (session.customTitle) {
+        label += `{#73daca-fg}{bold}${esc(topic)}{/}`;
+      } else {
+        label += `{#a9b1d6-fg}${esc(topic)}{/}`;
+      }
+
+      return label;
     });
 
     const items = [NEW_SESSION_LABEL, ...sessionItems];
@@ -471,14 +612,19 @@ function createApp() {
   function renderDetail() {
     if (selectedIndex === -1) {
       const cli = CLI.name;
+      const defaultMode = meta.defaultPermissionMode || '';
+      const modeFlag = (defaultMode && defaultMode !== 'default') ? ` --permission-mode ${defaultMode}` : '';
       let c = '';
-      c += `\n {#9ece6a-fg}{bold}✨ Start a New Conversation{/}\n`;
+      c += `\n {#9ece6a-fg}{bold}Start a New Conversation{/}\n`;
       c += ` {#414868-fg}${'─'.repeat(44)}{/}\n\n`;
       c += ` {#a9b1d6-fg}Open a fresh Claude session and start{/}\n`;
       c += ` {#a9b1d6-fg}coding from scratch.{/}\n\n`;
       c += ` {#565f89-fg}Working Dir{/}  {#7dcfff-fg}${process.cwd()}{/}\n`;
       c += ` {#565f89-fg}CLI{/}          {#73daca-fg}${cli}{/}\n`;
-      c += ` {#565f89-fg}Command{/}      {#565f89-fg}${cli}{/}\n\n`;
+      if (defaultMode && defaultMode !== 'default') {
+        c += ` {#565f89-fg}Mode{/}         {#f7768e-fg}${defaultMode}{/}\n`;
+      }
+      c += ` {#565f89-fg}Command{/}      {#565f89-fg}${cli}${modeFlag}{/}\n\n`;
       c += ` {#414868-fg}${'─'.repeat(44)}{/}\n`;
       c += ` {#9ece6a-fg}{bold}↵ Enter{/}{#9ece6a-fg} or {/}{#9ece6a-fg}{bold}n{/}{#9ece6a-fg} to launch{/}\n`;
       detailPanel.setContent(c);
@@ -498,7 +644,11 @@ function createApp() {
     let c = '';
     const sep = ` {#414868-fg}${'─'.repeat(44)}{/}`;
 
+    // Title
     c += `\n {${color}-fg}{bold}█ ${session.project}{/}\n`;
+    if (session.customTitle) {
+      c += ` {#73daca-fg}{bold}${esc(session.customTitle)}{/}\n`;
+    }
     c += sep + '\n\n';
 
     const fields = [
@@ -513,6 +663,12 @@ function createApp() {
     if (session.version) fields.push(['Claude', `{#565f89-fg}v${session.version}{/}`]);
     if (session.cwd) fields.push(['Directory', `{#565f89-fg}${session.cwd}{/}`]);
 
+    const effectiveMode = getEffectivePermissionMode(meta, session);
+    if (effectiveMode && effectiveMode !== 'default') {
+      const modeColor = effectiveMode === 'bypassPermissions' ? '#f7768e' : '#e0af68';
+      fields.push(['Mode', `{${modeColor}-fg}${effectiveMode}{/}`]);
+    }
+
     for (const [label, value] of fields) {
       c += ` {#565f89-fg}${label.padEnd(12)}{/} ${value}\n`;
     }
@@ -524,7 +680,7 @@ function createApp() {
       if (session.toolsUsed.length > 10) c += ` {#565f89-fg}+${session.toolsUsed.length - 10} more{/}\n`;
     }
 
-    c += `\n {#bb9af7-fg}{bold}💬 Conversation{/}\n`;
+    c += `\n {#bb9af7-fg}{bold}Conversation{/}\n`;
     c += sep + '\n';
 
     const msgs = (session.userMessages || []).slice(0, 10);
@@ -536,11 +692,11 @@ function createApp() {
       msgs.forEach((msg, i) => {
         const clean = esc(msg.replace(/\n/g, ' ').trim());
         const trunc = clean.length > 80 ? clean.substring(0, 80) + '…' : clean;
-        c += `\n {#7aa2f7-fg}{bold}You ❯{/} ${trunc}\n`;
+        c += `\n {#7aa2f7-fg}{bold}You >{/} ${trunc}\n`;
         if (assists[i]) {
           const aClean = esc(assists[i].replace(/\n/g, ' ').trim());
           const aTrunc = aClean.length > 80 ? aClean.substring(0, 80) + '…' : aClean;
-          c += ` {#9ece6a-fg}Claude ❯{/} {#565f89-fg}${aTrunc}{/}\n`;
+          c += ` {#9ece6a-fg}Claude >{/} {#565f89-fg}${aTrunc}{/}\n`;
         }
       });
     }
@@ -570,8 +726,11 @@ function createApp() {
     } else {
       const terms = filterText.toLowerCase().split(/\s+/);
       filteredSessions = allSessions.filter(s => {
-        const haystack = [s.project, s.topic, s.gitBranch || '', s.sessionId, ...(s.userMessages || [])].join(' ').toLowerCase();
-        return terms.every(t => haystack.includes(t));
+        const haystack = [s.project, s.topic, s.customTitle || '', s.gitBranch || '', s.sessionId, ...(s.userMessages || [])].join(' ').toLowerCase();
+
+        return terms.every(t => {
+          return haystack.includes(t);
+        });
       });
     }
     selectedIndex = Math.min(selectedIndex, Math.max(-1, filteredSessions.length - 1));
@@ -670,14 +829,17 @@ function createApp() {
   }
 
   screen.key(['down'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; updateHeader(); screen.render(); }
     moveSelection(1);
   });
   screen.key(['up'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; updateHeader(); screen.render(); }
     moveSelection(-1);
   });
   screen.key(['home'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; }
     selectedIndex = -1;
     suppressSelectEvent = true; listPanel.select(0); suppressSelectEvent = false;
@@ -685,6 +847,7 @@ function createApp() {
     renderDetail(); updateHeader(); screen.render();
   });
   screen.key(['end'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; }
     selectedIndex = Math.max(0, filteredSessions.length - 1);
     suppressSelectEvent = true; listPanel.select(selectedIndex + 1); suppressSelectEvent = false;
@@ -692,10 +855,12 @@ function createApp() {
     renderDetail(); updateHeader(); screen.render();
   });
   screen.key(['pagedown', 'C-d'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; updateHeader(); screen.render(); }
     moveSelection(Math.floor((listPanel.height || 20) / 2));
   });
   screen.key(['pageup', 'C-u'], () => {
+    if (popupOpen) return;
     if (isSearchMode) { isSearchMode = false; updateHeader(); screen.render(); }
     moveSelection(-Math.floor((listPanel.height || 20) / 2));
   });
@@ -725,35 +890,46 @@ function createApp() {
   // ─── Resume Session ─────────────────────────────────────────────────────
   // Auto-detect: use mai-claude if available, otherwise fall back to claude
 
-  function resumeSession(session) {
+  function resumeSession(session, modeOverride) {
+    process.stdout.write('\x1b[0m');
     screen.destroy();
 
     const label = CLI.name;
+    const mode = modeOverride || getEffectivePermissionMode(meta, session);
+    const modeFlag = (mode && mode !== 'default') ? ` --permission-mode ${mode}` : '';
 
     console.log(`\n\x1b[36m⚡ Resuming conversation with ${label}\x1b[0m`);
     console.log(`\x1b[90m   Session: ${session.sessionId}\x1b[0m`);
-    console.log(`\x1b[90m   Project: ${session.project}  │  Branch: ${session.gitBranch || 'N/A'}  │  Messages: ${session.estimatedMessages}\x1b[0m\n`);
+    console.log(`\x1b[90m   Project: ${session.project}  │  Branch: ${session.gitBranch || 'N/A'}  │  Messages: ${session.estimatedMessages}\x1b[0m`);
+    if (mode && mode !== 'default') console.log(`\x1b[33m   Mode: ${mode}\x1b[0m`);
+    console.log('');
 
     const child = spawn(
-      `${CLI.cmd} --resume ${session.sessionId}`,
+      `${CLI.cmd} --resume ${session.sessionId}${modeFlag}`,
       { stdio: 'inherit', cwd: session.cwd || process.cwd(), shell: true },
     );
     child.on('error', (err) => {
       console.error(`\x1b[31mFailed to resume: ${err.message}\x1b[0m`);
-      console.log(`\x1b[33mManual: ${label} --resume ${session.sessionId}\x1b[0m`);
+      console.log(`\x1b[33mManual: ${label} --resume ${session.sessionId}${modeFlag}\x1b[0m`);
       process.exit(1);
     });
     child.on('exit', (code) => process.exit(code || 0));
   }
 
   function startNewSession() {
+    process.stdout.write('\x1b[0m');
     screen.destroy();
 
     const label = CLI.name;
+    const mode = meta.defaultPermissionMode || '';
+    const modeFlag = (mode && mode !== 'default') ? ` --permission-mode ${mode}` : '';
 
-    console.log(`\n\x1b[36m✨ Starting new conversation with ${label}\x1b[0m\n`);
+    console.log(`\n\x1b[36m✨ Starting new conversation with ${label}\x1b[0m`);
+    if (mode && mode !== 'default') console.log(`\x1b[33m   Mode: ${mode}\x1b[0m`);
+    console.log('');
 
-    const child = spawn(CLI.cmd, { stdio: 'inherit', cwd: process.cwd(), shell: true });
+    const cmd = modeFlag ? `${CLI.cmd}${modeFlag}` : CLI.cmd;
+    const child = spawn(cmd, { stdio: 'inherit', cwd: process.cwd(), shell: true });
     child.on('error', (err) => {
       console.error(`\x1b[31mFailed to start: ${err.message}\x1b[0m`);
       process.exit(1);
@@ -789,13 +965,222 @@ function createApp() {
     } catch (e) { /* silently fail */ }
   });
 
+
+  // ─── Permission Mode Picker ──────────────────────────────────────────────
+
+  function showResumeConfirm(session) {
+    // Delay to avoid the Enter key from mode picker leaking into this popup
+    setTimeout(() => {
+      const mode = getEffectivePermissionMode(meta, session);
+      const modeLabel = (mode && mode !== 'default') ? `{#bb9af7-fg}${mode}{/}` : '{#565f89-fg}default{/}';
+      const confirmPopup = blessed.box({
+        parent: screen, top: 'center', left: 'center',
+        width: 44, height: 7,
+        label: ' {bold}{#9ece6a-fg}Resume?{/} ',
+        tags: true, border: { type: 'line' },
+        style: {
+          border: { fg: '#9ece6a' }, bg: '#24283b', fg: '#a9b1d6',
+          label: { fg: '#9ece6a' },
+        },
+        content: `\n  Mode: ${modeLabel}\n\n  {#9ece6a-fg}{bold}Enter{/}{#a9b1d6-fg} Resume  {/}{#565f89-fg}Esc{/}{#a9b1d6-fg} Cancel{/}`,
+      });
+      popupOpen = true;
+      confirmPopup.focus();
+      screen.render();
+
+      confirmPopup.key(['enter', 'return'], () => {
+        confirmPopup.destroy();
+        popupOpen = false;
+        resumeSession(session);
+      });
+      confirmPopup.key(['escape', 'q'], () => {
+        confirmPopup.destroy();
+        popupOpen = false;
+        renderAll();
+      });
+    }, 50);
+  }
+
+  function showPermissionModePicker(session) {
+    const currentSessionMode = (meta.sessions[session.sessionId] && meta.sessions[session.sessionId].permissionMode) || '';
+    const currentGlobalMode = meta.defaultPermissionMode || '';
+    const effectiveMode = getEffectivePermissionMode(meta, session);
+
+    const items = [
+      '  {#bb9af7-fg}{bold}── Session Override ──{/}',
+      ...PERMISSION_MODES.map(m => {
+        const checked = currentSessionMode === m ? '{#9ece6a-fg}✓{/}' : ' ';
+        const label = m === 'default' ? 'default (none)' : m;
+        return `  ${checked} {#a9b1d6-fg}${label}{/}`;
+      }),
+      '  {#7aa2f7-fg}{bold}Clear session override{/}',
+      '',
+      '  {#bb9af7-fg}{bold}── Global Default ──{/}',
+      ...PERMISSION_MODES.map(m => {
+        const checked = currentGlobalMode === m ? '{#9ece6a-fg}✓{/}' : ' ';
+        const label = m === 'default' ? 'default (none)' : m;
+        return `  ${checked} {#a9b1d6-fg}${label}{/}`;
+      }),
+      '  {#7aa2f7-fg}{bold}Clear global default{/}',
+    ];
+
+    const popup = blessed.list({
+      parent: screen, top: 'center', left: 'center',
+      width: 42,
+      height: Math.min(items.length + 4, 24),
+      label: ' {bold}{#bb9af7-fg}Permission Mode{/} ',
+      tags: true, border: { type: 'line' },
+      style: {
+        border: { fg: '#bb9af7' }, bg: '#24283b', fg: '#a9b1d6',
+        selected: { bg: '#3d59a1', fg: 'white', bold: true },
+        label: { fg: '#bb9af7' },
+      },
+      items: items, keys: true, vi: true, mouse: true,
+    });
+    popupOpen = true;
+    popup.focus(); screen.render();
+
+    // Section header indices (0-indexed)
+    const sessionHeaderIdx = 0;
+    const sessionClearIdx = PERMISSION_MODES.length + 1;
+    const spacerIdx = sessionClearIdx + 1;
+    const globalHeaderIdx = spacerIdx + 1;
+    const globalClearIdx = globalHeaderIdx + PERMISSION_MODES.length + 1;
+
+    popup.on('select', (item, index) => {
+      // Skip headers and spacer
+      if (index === sessionHeaderIdx || index === globalHeaderIdx || index === spacerIdx) return;
+
+      if (index === sessionClearIdx) {
+        // Clear session override
+        setSessionPermissionMode(meta, session.sessionId, '');
+        popup.destroy(); popupOpen = false; renderAll();
+        showResumeConfirm(session);
+        return;
+      }
+
+      if (index === globalClearIdx) {
+        // Clear global default
+        setGlobalPermissionMode(meta, '');
+        footer.setContent(`\n  {#9ece6a-fg}{bold}> Global default mode cleared{/}`);
+        popup.destroy(); popupOpen = false; renderAll();
+        setTimeout(() => { updateFooter(); screen.render(); }, 1500);
+        return;
+      }
+
+      // Session mode selection (indices 1 to PERMISSION_MODES.length)
+      if (index > sessionHeaderIdx && index <= sessionClearIdx - 1) {
+        const mode = PERMISSION_MODES[index - 1];
+        setSessionPermissionMode(meta, session.sessionId, mode === 'default' ? '' : mode);
+        popup.destroy(); popupOpen = false; renderAll();
+        showResumeConfirm(session);
+        return;
+      }
+
+      // Global mode selection
+      if (index > globalHeaderIdx && index <= globalClearIdx - 1) {
+        const mode = PERMISSION_MODES[index - globalHeaderIdx - 1];
+        setGlobalPermissionMode(meta, mode === 'default' ? '' : mode);
+        footer.setContent(`\n  {#9ece6a-fg}{bold}> Global default:{/} {#bb9af7-fg}${mode}{/}`);
+        popup.destroy(); popupOpen = false; renderAll();
+        setTimeout(() => { updateFooter(); screen.render(); }, 1500);
+        return;
+      }
+    });
+
+    popup.key(['escape', 'q'], () => {
+      popup.destroy();
+      popupOpen = false;
+      renderAll();
+    });
+  }
+
+  // ─── Quick dangerous resume (d key) ────────────────────────────────────
+  screen.key(['d'], () => {
+    if (isSearchMode || popupOpen) return;
+    if (selectedIndex < 0 || selectedIndex >= filteredSessions.length) return;
+    resumeSession(filteredSessions[selectedIndex], 'bypassPermissions');
+  });
+
+  // ─── Permission mode picker (m key) ───────────────────────────────────
+  screen.key(['m'], () => {
+    if (isSearchMode || popupOpen) return;
+    if (selectedIndex < 0 || selectedIndex >= filteredSessions.length) return;
+    showPermissionModePicker(filteredSessions[selectedIndex]);
+  });
+
+  // ─── Delete Session ───────────────────────────────────────────────────
+  function deleteSession(session) {
+    try {
+      // Delete the .jsonl file
+      if (fs.existsSync(session.filePath)) {
+        fs.unlinkSync(session.filePath);
+      }
+      // Clean up meta entry
+      if (meta.sessions[session.sessionId]) {
+        delete meta.sessions[session.sessionId];
+        saveMeta(meta);
+      }
+      // Remove from in-memory arrays
+      const allIdx = allSessions.indexOf(session);
+      if (allIdx !== -1) allSessions.splice(allIdx, 1);
+      const filtIdx = filteredSessions.indexOf(session);
+      if (filtIdx !== -1) filteredSessions.splice(filtIdx, 1);
+      // Adjust selection
+      if (selectedIndex >= filteredSessions.length) {
+        selectedIndex = Math.max(-1, filteredSessions.length - 1);
+      }
+    } catch (e) { /* silently fail */ }
+  }
+
+  function showDeleteConfirm(session) {
+    const topic = (session.customTitle || session.topic || '').substring(0, 30);
+    const confirmPopup = blessed.box({
+      parent: screen, top: 'center', left: 'center',
+      width: 50, height: 9,
+      label: ' {bold}{#f7768e-fg}Delete Session?{/} ',
+      tags: true, border: { type: 'line' },
+      style: {
+        border: { fg: '#f7768e' }, bg: '#24283b', fg: '#a9b1d6',
+        label: { fg: '#f7768e' },
+      },
+      content:
+        `\n  {#a9b1d6-fg}${esc(topic)}{/}\n`
+        + `  {#565f89-fg}${session.sessionId}{/}\n\n`
+        + `  {#f7768e-fg}{bold}y{/}{#a9b1d6-fg} Delete  {/}{#565f89-fg}n / Esc{/}{#a9b1d6-fg} Cancel{/}`,
+    });
+    popupOpen = true;
+    confirmPopup.focus();
+    screen.render();
+
+    confirmPopup.key(['y'], () => {
+      confirmPopup.destroy();
+      popupOpen = false;
+      deleteSession(session);
+      footer.setContent(`\n  {#f7768e-fg}{bold}✗ Deleted:{/} {#565f89-fg}${session.sessionId}{/}`);
+      renderAll();
+      setTimeout(() => { updateFooter(); screen.render(); }, 1500);
+    });
+    confirmPopup.key(['n', 'escape', 'q'], () => {
+      confirmPopup.destroy();
+      popupOpen = false;
+      screen.render();
+    });
+  }
+
+  screen.key(['x', 'delete'], () => {
+    if (isSearchMode || popupOpen) return;
+    if (selectedIndex < 0 || selectedIndex >= filteredSessions.length) return;
+    showDeleteConfirm(filteredSessions[selectedIndex]);
+  });
+
   screen.key(['s'], () => { if (!isSearchMode) cycleSort(); });
   screen.key(['p'], () => { if (!isSearchMode) showProjectPicker(); });
   screen.key(['escape'], () => {
     if (isSearchMode) { isSearchMode = false; filterText = ''; applyFilter(); return; }
     filterText = ''; selectedIndex = -1; applyFilter();
   });
-  screen.key(['q', 'C-c'], () => { screen.destroy(); process.exit(0); });
+  screen.key(['q', 'C-c'], () => { process.stdout.write('\x1b[0m'); screen.destroy(); process.exit(0); });
 
   // Remove blessed's built-in wheel handlers (they call select which changes selection)
   listPanel.removeAllListeners('element wheeldown');
@@ -844,25 +1229,76 @@ function createApp() {
 
 // ─── Entry Point ─────────────────────────────────────────────────────────────
 
+const PKG = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf-8'));
+
 const args = process.argv.slice(2);
 
+if (args.includes('--version') || args.includes('-v') || args.includes('-V')) {
+  console.log(`claude-starter v${PKG.version}`);
+  process.exit(0);
+}
+
+if (args.includes('--update') || args.includes('-u')) {
+  const C = {
+    reset: '\x1b[0m', dim: '\x1b[2m', bold: '\x1b[1m',
+    cyan: '\x1b[36m', yellow: '\x1b[33m', green: '\x1b[32m',
+    red: '\x1b[31m',
+  };
+  console.log(`\n${C.cyan}🔄 Checking for updates…${C.reset}\n`);
+
+  try {
+    const latest = execSync('npm view claude-starter version 2>/dev/null', {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    }).toString().trim();
+
+    if (latest === PKG.version) {
+      console.log(`${C.green}✓ Already on the latest version (v${PKG.version})${C.reset}\n`);
+      process.exit(0);
+    }
+
+    console.log(`${C.yellow}  Current: v${PKG.version}${C.reset}`);
+    console.log(`${C.green}  Latest:  v${latest}${C.reset}\n`);
+    console.log(`${C.cyan}📦 Updating…${C.reset}\n`);
+
+    try {
+      execSync('npm install -g claude-starter@latest', { stdio: 'inherit', timeout: 60000 });
+      console.log(`\n${C.green}${C.bold}✓ Updated to v${latest}${C.reset}\n`);
+    } catch (e) {
+      console.error(`\n${C.red}✗ Update failed. Try manually:${C.reset}`);
+      console.log(`${C.yellow}  npm install -g claude-starter@latest${C.reset}\n`);
+      process.exit(1);
+    }
+  } catch (e) {
+    console.error(`${C.red}✗ Could not check for updates (network error or npm not found)${C.reset}\n`);
+    process.exit(1);
+  }
+
+  process.exit(0);
+}
+
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`
-\x1b[36m🚀 Claude Starter\x1b[0m
+\x1b[36m🚀 Claude Starter\x1b[0m  \x1b[2mv${PKG.version}\x1b[0m
 
 Usage:
-  claude-starter            Launch interactive TUI
-  claude-starter --list [N] Print latest N sessions (default: 30)
-  claude-starter --help     Show this help
+  claude-starter              Launch interactive TUI
+  claude-starter --list [N]   Print latest N sessions (default: 30)
+  claude-starter --version    Show version
+  claude-starter --update     Update to the latest version
+  claude-starter --help       Show this help
 
 TUI Keyboard Shortcuts:
   ↑/↓           Navigate sessions
   Enter         Start new / resume selected session
   n             Start new session
+  d             Resume with bypassPermissions (danger mode)
+  m             Permission mode picker
   /             Search (fuzzy filter)
   p             Filter by project
-  s             Cycle sort mode
+  s             Cycle sort mode (time/size/messages/project)
   c             Copy session ID
+  x / Delete    Delete selected session
   Home / End    Jump to top / bottom
   Ctrl-D/U      Page down / up
   Esc           Clear filter

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-starter",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "A beautiful terminal UI for managing Claude Code sessions — start new or resume past conversations",
   "main": "index.js",
   "bin": {