claude-starter 1.3.5 → 1.4.1

package/README.md

@@ -15,6 +15,10 @@
   <strong>Claude Code 的主页。</strong>你的所有会话，一目了然。
 </p>
 
+<p align="center">
+  Built for <strong>AI-native developer workflows</strong>: local-first, searchable, resumable, and fast — so the next session starts faster than the last one ended.
+</p>
+
 <p align="center">
   <code>npm install -g claude-starter</code>&nbsp;&nbsp;→&nbsp;&nbsp;<code>claude-starter</code>
 </p>
@@ -31,6 +35,8 @@
 
 Claude Code's `/resume` gives you a wall of UUIDs:
 
+If you use Claude Code as part of a real development loop, session history stops being archive data and becomes working context. You need to find old agent work by repo, topic, and intent — not by opaque IDs.
+
 ```
 ? Select a conversation
   3ee0f33a-b882-424f-9ba4-260342e4dd5b - 4/3/2026, 10:53:41 AM
@@ -48,6 +54,8 @@ claude-starter
 
 Beautiful split-pane UI with Tokyo Night colors. The left panel shows every session with project, time, and topic. The right panel previews the full conversation. Not UUIDs — your **actual words**.
 
+`claude-starter` is built for developers treating coding agents as part of a daily workflow: keep everything local, cut resume friction, and make past conversations actually reusable.
+
 ## 🔍 Search — The Killer Feature
 
 Press `/` and start typing. **That's it.** No Enter needed.
@@ -140,6 +148,11 @@ Reads the JSONL session files from `~/.claude/projects/`, parses metadata and co
 - **Node.js** >= 18
 - **Claude Code** ([`claude`](https://docs.anthropic.com/en/docs/claude-code) in PATH)
 
+## Related Projects
+
+- **[codex-starter](https://github.com/Bojun-Vvibe/codex-starter)** — the Codex counterpart with the same local-first workflow philosophy
+- **[Bojun-Vvibe](https://github.com/Bojun-Vvibe)** — more terminal UX and AI-native workflow experiments
+
 ## License
 
 MIT

package/index.js

@@ -9,6 +9,7 @@
  *   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 --exclude "pat"  # Exclude sessions matching regex (repeatable)
  *   claude-starter --version  # Show version
  *   claude-starter --update   # Update to the latest version
  *
@@ -35,6 +36,10 @@ const path = require('path');
 const { spawn, execSync } = require('child_process');
 const os = require('os');
 
+let excludePatterns = [];
+
+function setExcludePatterns(patterns) { excludePatterns = patterns; }
+
 // ─── CLI Detection ──────────────────────────────────────────────────────────
 // Detect whether `mai-claude` is available (binary, alias, or function).
 // First checks PATH directly, then sources shell config non-interactively
@@ -417,6 +422,7 @@ function loadAllSessions() {
         if (session.firstTs
             && session.topic !== '(no user messages)'
             && !/^warmup$/i.test(session.topic.trim())
+            && !excludePatterns.some(re => re.test(session.topic))
         ) sessions.push(session);
       } catch (e) { /* skip */ }
     }
@@ -764,7 +770,9 @@ function createApp() {
     c += `\n {#bb9af7-fg}{bold}Conversation{/}\n`;
     c += sep + '\n';
 
-    const msgs = (session.userMessages || []).slice(0, 10);
+    const detailHeight = detailPanel.height || screen.height || 24;
+    const previewLimit = Math.max(10, Math.floor(Math.max(0, detailHeight - 18) / 3));
+    const msgs = (session.userMessages || []).slice(0, previewLimit);
     const assists = (session.assistantSnippets || []);
 
     if (msgs.length === 0) {
@@ -1532,6 +1540,7 @@ if (typeof module !== 'undefined') {
     getEffectivePermissionMode,
     setSessionPermissionMode,
     setGlobalPermissionMode,
+    setExcludePatterns,
     // Constants
     PERMISSION_MODES,
     PROJECT_COLORS,
@@ -1555,6 +1564,20 @@ if (require.main === module) {
 
   const args = process.argv.slice(2);
 
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--exclude' && args[i + 1]) {
+      try { excludePatterns.push(new RegExp(args[i + 1], 'i')); } catch {}
+      i++;
+    }
+  }
+  if (process.env.CLAUDE_STARTER_EXCLUDE) {
+    for (const p of process.env.CLAUDE_STARTER_EXCLUDE.split(',')) {
+      if (p.trim()) {
+        try { excludePatterns.push(new RegExp(p.trim(), 'i')); } catch {}
+      }
+    }
+  }
+
   if (args.includes('--version') || args.includes('-v') || args.includes('-V')) {
     console.log(`claude-starter v${PKG.version}`);
     process.exit(0);
@@ -1606,10 +1629,14 @@ if (require.main === module) {
 Usage:
   claude-starter              Launch interactive TUI
   claude-starter --list [N]   Print latest N sessions (default: 30)
+  claude-starter --exclude "pat"  Exclude sessions matching regex (repeatable)
   claude-starter --version    Show version
   claude-starter --update     Update to the latest version
   claude-starter --help       Show this help
 
+Environment Variables:
+  CLAUDE_STARTER_EXCLUDE=pat1,pat2   Comma-separated regex patterns to exclude
+
 TUI Keyboard Shortcuts:
   ↑/↓           Navigate sessions
   Enter         Start new / resume selected session

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-starter",
-  "version": "1.3.5",
+  "version": "1.4.1",
   "description": "A beautiful terminal UI for managing Claude Code sessions — start new or resume past conversations",
   "main": "index.js",
   "bin": {
@@ -20,7 +20,11 @@
     "terminal",
     "session",
     "resume",
-    "ai"
+    "ai",
+    "ai-native",
+    "developer-workflow",
+    "local-first",
+    "agentic-tooling"
   ],
   "author": "Bojun Chai <just_cbj@sina.com>",
   "license": "MIT",
@@ -28,6 +32,10 @@
     "type": "git",
     "url": "https://github.com/Bojun-Vvibe/claude-starter.git"
   },
+  "homepage": "https://github.com/Bojun-Vvibe/claude-starter#readme",
+  "bugs": {
+    "url": "https://github.com/Bojun-Vvibe/claude-starter/issues"
+  },
   "engines": {
     "node": ">=18"
   },