claude-term-tabs 2.1.2 → 2.1.4

package/README.md

@@ -6,12 +6,14 @@
 
 Find a running Claude Code session by what you remember about it, and switch to its terminal tab.
 
+![ctt switching to a session by a few words, ctt pause --auto-close closing every session once it has written a HANDOFF, then ctt resume reopening them all](https://raw.githubusercontent.com/ecoutu/claude-term-tabs/main/docs/demo.gif)
+
 ```bash
 ctt working on pause in claude-term-tabs
 # → Pause sessions before a restart · claude-term-tabs · tab 4
 ```
 
-Works with iTerm2 and WezTerm on macOS.
+Works with iTerm2 on macOS, and WezTerm on macOS and Linux.
 
 ## Install
 
@@ -149,6 +151,9 @@ npm run test:package   # packs, installs and runs the npm package
 No runtime dependencies. A clone runs the TypeScript directly; the npm package ships it built to JavaScript.
 [CONTRIBUTING.md](CONTRIBUTING.md) has the commit and pull request rules.
 
+`scripts/record-demo.sh` re-records `docs/demo.gif`. It runs Claude Code sessions in a scratch HOME on a hidden
+display, so it needs Linux, Xvfb, ffmpeg and a token from `claude setup-token`; its header lists the rest.
+
 ### Releases
 
 Every push to `main` runs CI, then semantic-release reads the conventional commit

package/dist/cache.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync, statSync } from 'node:fs';
 import { writeOwnerOnly } from "./fsutil.js";
-const CACHE_VERSION = 1;
+const CACHE_VERSION = 2;
 /** Digest cache keyed by transcript path, valid while the file's size and mtime are unchanged. */
 export class DigestCache {
     file;

package/dist/handoff.js

@@ -1,4 +1,5 @@
 import { closeSync, fstatSync, openSync, readSync } from 'node:fs';
+import { withoutPasteTags } from "./transcript.js";
 const DEFAULT_TAIL_BYTES = 128 * 1024;
 const HANDOFF_LINE = /^\s*(?:#+\s*|\*\*)?HANDOFF\b(?!S)/m;
 /**
@@ -94,7 +95,7 @@ export function latestAssistantAfterPrompt(path, promptStart, sinceMs, opts = {}
             const start = Math.max(0, size - window);
             const lines = readRange(fd, start, size - start).split('\n');
             const entries = (start > 0 ? lines.slice(1) : lines).flatMap(l => parse(l) ?? []);
-            const promptAt = findLastIndex(entries, e => e.type === 'user' && Date.parse(String(e.timestamp)) >= sinceMs && (textOf(e.message) ?? '').trimStart().startsWith(promptStart));
+            const promptAt = findLastIndex(entries, e => e.type === 'user' && Date.parse(String(e.timestamp)) >= sinceMs && withoutPasteTags(textOf(e.message) ?? '').trimStart().startsWith(promptStart));
             if (promptAt >= 0) {
                 const replies = entries.slice(promptAt + 1).filter(e => e.type === 'assistant').map(e => textOf(e.message)).filter((t) => t !== undefined);
                 return replies.at(-1);

package/dist/pause/ui.js

@@ -4,7 +4,7 @@ import { mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { writeOwnerOnly } from "../fsutil.js";
-import { createServer } from 'node:net';
+import { connect, createServer } from 'node:net';
 import { createInterface } from 'node:readline';
 import { tickPause, stragglerLines } from "./run.js";
 import { FINAL_STATES } from "./state.js";
@@ -12,6 +12,7 @@ import { shellQuote } from "../shell.js";
 /** How often the straggler list refreshes. */
 export const POLL_MS = 3000;
 const CLEAR = '\x1b[2J\x1b[H';
+const LISTEN_WAIT_MS = 2000;
 const SAFE_PATH = /^[A-Za-z0-9._\/-]+$/;
 const HEADER = 'ctt pause: Enter or double-click jumps to a session · ctrl-r re-sends the stop prompt · Esc stops waiting';
 /** fzf arguments for the live straggler list; `self` is the argv prefix that re-invokes ctt. */
@@ -105,7 +106,9 @@ async function fzfUi(io, initial) {
     child.on('exit', () => { exited = true; });
     child.on('error', () => { exited = true; });
     child.stdin.end(initial.join('\n'));
-    const post = async (action) => {
+    await listening(port, () => exited);
+    // `abort` closes fzf, which often exits before it answers, so its failure is expected.
+    const post = async (action, closing = false) => {
         if (exited)
             return;
         try {
@@ -114,7 +117,7 @@ async function fzfUi(io, initial) {
                 process.stderr.write(`claude-term-tabs: the list refused an update (${res.status})\n`);
         }
         catch (err) {
-            if (!exited)
+            if (!exited && !closing)
                 process.stderr.write(`claude-term-tabs: could not update the list: ${err.message}\n`);
         }
     };
@@ -124,7 +127,7 @@ async function fzfUi(io, initial) {
             await post(reloadAction(linesFile));
         },
         finish: async () => {
-            await post('abort');
+            await post('abort', true);
             if (!exited)
                 await new Promise(resolve => child.once('exit', () => resolve()));
             rmSync(dir, { recursive: true, force: true });
@@ -132,6 +135,20 @@ async function fzfUi(io, initial) {
         closed: () => exited
     };
 }
+/** Resolves once fzf accepts connections on `port`, it has exited, or LISTEN_WAIT_MS has passed. */
+async function listening(port, gone) {
+    const deadline = Date.now() + LISTEN_WAIT_MS;
+    while (!gone() && Date.now() < deadline) {
+        const up = await new Promise(resolve => {
+            const socket = connect(port, '127.0.0.1');
+            socket.once('connect', () => { socket.destroy(); resolve(true); });
+            socket.once('error', () => { resolve(false); });
+        });
+        if (up)
+            return;
+        await new Promise(resolve => setTimeout(resolve, 50));
+    }
+}
 function freePort() {
     return new Promise((resolve, reject) => {
         const server = createServer();

package/dist/terminals/wezterm.js

@@ -6,9 +6,12 @@ export function weztermAdapter(exec, shell = process.env.SHELL ?? '/bin/sh') {
             throw new Error(`wezterm cli ${args[0]} failed (${r.status}): ${r.stderr.trim()}`);
         return r.stdout;
     };
+    const list = () => JSON.parse(cli(['list', '--format', 'json']));
+    // A spawn without --window-id lands in the caller's window, so tabs that follow a new window go there explicitly.
+    let newWindowPane;
     return {
         name: 'wezterm',
-        listPanes: () => toPanes(JSON.parse(cli(['list', '--format', 'json']))),
+        listPanes: () => toPanes(list()),
         focus: (pane) => { cli(['activate-pane', '--pane-id', pane.id]); },
         sendText: (pane, text) => {
             cli(['send-text', '--pane-id', pane.id, text]);
@@ -16,7 +19,15 @@ export function weztermAdapter(exec, shell = process.env.SHELL ?? '/bin/sh') {
         },
         closePane: (pane) => { cli(['kill-pane', '--pane-id', pane.id]); },
         openPane: (cwd, command, opts) => {
-            return cli(['spawn', ...(opts?.newWindow === true ? ['--new-window'] : []), '--cwd', cwd, '--', shell, '-lc', `${command}; exec ${shell} -l`]).trim();
+            const newWindow = opts?.newWindow === true;
+            const windowId = newWindow || newWindowPane === undefined ? undefined : list().find(p => String(p.pane_id) === newWindowPane)?.window_id;
+            const where = newWindow ? ['--new-window'] : windowId !== undefined ? ['--window-id', String(windowId)] : [];
+            if (newWindow)
+                newWindowPane = undefined;
+            const id = cli(['spawn', ...where, '--cwd', cwd, '--', shell, '-lc', `${command}; exec ${shell} -l`]).trim();
+            if (newWindow)
+                newWindowPane = id;
+            return id;
         }
     };
 }

package/dist/transcript.js

@@ -4,6 +4,8 @@ const HEAD_BYTES = 64 * 1024;
 const DEFAULT_TAIL_BYTES = 256 * 1024;
 const PROMPT_CHARS = 200;
 const WRAPPER_PREFIXES = ['<command', '<local-command', '<system', '<user-prompt-submit-hook', 'Caveat:'];
+/** Claude Code records pasted text between `<pasted_content id="…">` and `</pasted_content id="…">` tags. */
+const PASTE_TAG = /<\/?pasted_content\b[^>]*>/g;
 /**
  * Build a Digest from a transcript by reading its head (first prompt, cwd) and a tail window
  * (latest title, last prompt, branch). A missing or unreadable file yields the fallback fields
@@ -120,7 +122,12 @@ function userText(message) {
 function trimPrompt(text) {
     if (text === undefined)
         return undefined;
-    return text.replace(/\s+/g, ' ').trim().slice(0, PROMPT_CHARS);
+    const prompt = withoutPasteTags(text).replace(/\s+/g, ' ').trim().slice(0, PROMPT_CHARS);
+    return prompt === '' ? undefined : prompt;
+}
+/** A prompt as it was typed, without the tags Claude Code puts around pasted text. */
+export function withoutPasteTags(text) {
+    return text.replace(PASTE_TAG, '');
 }
 function str(v) {
     return typeof v === 'string' && v !== '' ? v : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-term-tabs",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Find a running Claude Code session by what you remember, and jump to its terminal tab",
   "type": "module",
   "license": "MIT",
@@ -47,6 +47,7 @@
     "@semantic-release/changelog": "7.0.0",
     "@semantic-release/git": "11.0.1",
     "@types/node": "24.19.2",
+    "conventional-changelog-conventionalcommits": "9.3.1",
     "husky": "9.1.7",
     "semantic-release": "25.0.9",
     "typescript": "5.9.3"