sessioner 0.1.0 → 0.1.2

package/README.md

@@ -32,8 +32,6 @@ Claude Code supports native forking from specific points, but loses context like
 npm i sessioner
 ```
 
-> Requires **Node.js >= 22**.
-
 ---
 
 ## 🚀 Quick Start
@@ -58,7 +56,7 @@ sessioner
 ## 🔍 How It Works
 
 1. Scans `{base}/{project}` for `.jsonl` session files
-2. Shows a **main menu** (Sessions, Stats, Clean)
+2. Shows a **main menu** (Sessions, Search, Stats, Clean)
 3. Shows a **paginated session list** sorted by date (newest first)
 4. Displays a **conversation preview** for the selected session (up to 10 messages)
 5. Opens an **action menu** to operate on it
@@ -89,6 +87,19 @@ sessioner
 
 ---
 
+### Search (across all sessions)
+
+- Text input for a search query
+- Streams all sessions in parallel for case-insensitive text matching
+- Results grouped by session title, with match count and date
+- Matched text highlighted in bold
+- Paginated 10 matches at a time
+- Clicking a match opens the session's action menu
+- Back from the action menu returns to search results
+- Shows "No results" when nothing matches
+
+---
+
 ### Fork
 
 - Creates an independent copy of the entire session
@@ -114,9 +125,10 @@ sessioner
 - Analyzes the session and reports what can be removed:
   - **Tool blocks**: `tool_use` and `tool_result` entries
   - **Empty messages**: no text content after tools are stripped
-  - **Short messages**: text under 50 characters
   - **System/IDE tags**: `<system-reminder>`, `<ide_selection>`, `<ide_opened_file>`
-- Checkbox selection for what to remove (all pre-selected by default)
+  - **Old custom titles**: duplicate `custom-title` entries (keeps the most recent)
+  - **Short messages**: text under 50 characters (unselected by default)
+- Checkbox selection for what to remove (all pre-selected by default, except short messages)
 - Repairs the parent-child UUID chain after pruning
 - Shows "Nothing to prune" when the session is already clean
 
@@ -135,11 +147,7 @@ sessioner
 ### Rename
 
 - Text input for the new title (<kbd>Esc</kbd> to cancel)
-- Updates three locations:
-  - Session file (prepends a `session_title` line)
-  - Sessions index (`sessions-index.json`)
-  - First user message (injects title into metadata)
-- Tracks renames in a local cache (`.cache/renames.json`)
+- Writes a `custom-title` entry to the session file (same format used by the Claude Code extension)
 
 ---
 
@@ -148,7 +156,7 @@ sessioner
 - Shows exactly what will be deleted:
   - Session `.jsonl` file
   - Subagents directory (with file count)
-- Removes the entry from the sessions index and rename cache
+- Removes the entry from the sessions index
 - Confirmation prompt before applying
 
 ---

package/lib/actions/delete.js

@@ -1,6 +1,5 @@
 import { readFile, rm, unlink, writeFile } from 'node:fs/promises';
 import { basename, dirname, join } from 'node:path';
-import { readCache, writeCache } from '../helpers/rename-cache.js';
 import { countSubagents } from '../sessions/count-subagents.js';
 export const targets = async (session) => {
     const name = basename(session.file);
@@ -23,16 +22,6 @@ const removeFromIndex = async (session) => {
     }
     catch { }
 };
-const removeFromCache = async (session) => {
-    try {
-        const cache = await readCache();
-        if (!(session.file in cache))
-            return;
-        delete cache[session.file];
-        await writeCache(cache);
-    }
-    catch { }
-};
 export const cleanEmpty = async (files) => {
     for (const file of files) {
         const id = basename(file, '.jsonl');
@@ -53,5 +42,4 @@ export const remove = async (session) => {
     }
     catch { }
     await removeFromIndex(session);
-    await removeFromCache(session);
 };

package/lib/actions/merge.js

@@ -9,7 +9,7 @@ const buildUuidMap = (lines) => {
             continue;
         try {
             const parsed = JSON.parse(line);
-            if (parsed.type === 'session_title')
+            if (parsed.type === 'session_title' || parsed.type === 'custom-title')
                 continue;
             if (parsed.uuid)
                 uuidMap.set(parsed.uuid, randomUUID());
@@ -26,7 +26,7 @@ const remapSession = (lines, uuidMap, sessionId, previousLastUuid) => {
             continue;
         try {
             const parsed = JSON.parse(line);
-            if (parsed.type === 'session_title')
+            if (parsed.type === 'session_title' || parsed.type === 'custom-title')
                 continue;
             if (parsed.uuid) {
                 const newUuid = uuidMap.get(parsed.uuid);

package/lib/actions/preview.js

@@ -29,7 +29,7 @@ export const preview = (session, limit = PREVIEW_LIMIT) => new Promise((resolve)
         const entry = parseLine(line);
         if (!entry)
             return;
-        if (entry.type === 'session_title')
+        if (entry.type === 'session_title' || entry.type === 'custom-title')
             return;
         const texts = entry.message?.content ?? [];
         for (const block of texts) {

package/lib/actions/prune.js

@@ -75,11 +75,25 @@ export const prune = async (session, options) => {
     const lines = raw.split('\n');
     const kept = [];
     const survivingUuids = new Set();
-    for (const line of lines) {
+    let lastTitleIndex = -1;
+    if (options.customTitles) {
+        for (let index = 0; index < lines.length; index++) {
+            try {
+                const parsed = JSON.parse(lines[index] ?? '');
+                if (parsed.type === 'custom-title')
+                    lastTitleIndex = index;
+            }
+            catch { }
+        }
+    }
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index] ?? '';
         if (!line.trim())
             continue;
         try {
             const parsed = JSON.parse(line);
+            if (parsed.type === 'custom-title' && index !== lastTitleIndex)
+                continue;
             if (hasContent(parsed)) {
                 const content = filterContent(parsed.message.content, options);
                 if (shouldSkipMessage(parsed.type, content, options))

package/lib/actions/rename.js

@@ -1,87 +1,9 @@
-import { readFile, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { readCache, writeCache } from '../helpers/rename-cache.js';
-const updateIndex = async (session, title) => {
-    const path = join(dirname(session.file), 'sessions-index.json');
-    try {
-        const raw = await readFile(path, 'utf-8');
-        const index = JSON.parse(raw);
-        const entry = index.entries.find((item) => item.sessionId === session.id);
-        if (!entry)
-            return;
-        entry.firstPrompt = title;
-        await writeFile(path, JSON.stringify(index, null, 2));
-    }
-    catch { }
-};
-const stripExistingTitle = (content) => {
-    const newline = content.indexOf('\n');
-    if (newline === -1)
-        return content;
-    try {
-        const parsed = JSON.parse(content.slice(0, newline));
-        if (parsed.type === 'session_title')
-            return content.slice(newline + 1);
-    }
-    catch { }
-    return content;
-};
-const isUserLine = (value) => typeof value === 'object' &&
-    value !== null &&
-    value.type === 'user' &&
-    Array.isArray(value.message?.content);
-const isTextBlock = (block) => block.type === 'text' &&
-    typeof block.text === 'string' &&
-    !block.text.startsWith('<');
-const updateUserMessage = async (filePath, title) => {
-    const cache = await readCache();
-    const previous = cache[filePath];
-    const raw = await readFile(filePath, 'utf-8');
-    const lines = raw.split('\n');
-    for (let index = 0; index < lines.length; index++) {
-        const current = lines[index];
-        if (!current?.trim())
-            continue;
-        let parsed;
-        try {
-            parsed = JSON.parse(current);
-        }
-        catch {
-            continue;
-        }
-        if (!isUserLine(parsed))
-            continue;
-        const content = parsed.message.content;
-        for (const block of content) {
-            delete block._renamed;
-        }
-        let replaced = false;
-        if (previous) {
-            const existing = content.findIndex((block) => block.type === 'text' && block.text === previous);
-            const match = content[existing];
-            if (existing !== -1 && match) {
-                match.text = title;
-                replaced = true;
-            }
-        }
-        if (!replaced) {
-            const target = content.findIndex(isTextBlock);
-            if (target === -1)
-                break;
-            content.splice(target, 0, { type: 'text', text: title });
-        }
-        lines[index] = JSON.stringify(parsed);
-        await writeFile(filePath, lines.join('\n'));
-        cache[filePath] = title;
-        await writeCache(cache);
-        return;
-    }
-};
+import { appendFile } from 'node:fs/promises';
 export const rename = async (session, title) => {
-    const raw = await readFile(session.file, 'utf-8');
-    const content = stripExistingTitle(raw);
-    const line = JSON.stringify({ type: 'session_title', title });
-    await writeFile(session.file, `${line}\n${content}`);
-    await updateIndex(session, title);
-    await updateUserMessage(session.file, title);
+    const entry = JSON.stringify({
+        type: 'custom-title',
+        sessionId: session.id,
+        customTitle: title,
+    });
+    await appendFile(session.file, `\n${entry}`);
 };

package/lib/bin/index.js

@@ -15,7 +15,9 @@ import { analyze } from '../sessions/analyze-prune.js';
 import { countSubagents } from '../sessions/count-subagents.js';
 import { extractMessages } from '../sessions/extract-messages.js';
 import { listSessions } from '../sessions/list-sessions.js';
+import { searchSessions } from '../sessions/search-sessions.js';
 import { projectStats, stats } from '../sessions/stats.js';
+import { promptSearch, selectSearchResult, showNoResults, } from '../ui/search.js';
 import { promptConfirm, promptTitle, select, selectAction, selectMain, selectMultiple, selectPruneOptions, selectTrimLine, showProjectStats, } from '../ui/select.js';
 const usage = [
     'Usage: sessioner [options]',
@@ -50,6 +52,147 @@ if (process.stdin.isTTY) {
 }
 const project = values.project ?? process.cwd();
 const base = values.base ?? join(homedir(), '.claude', 'projects');
+const handleSession = async (initial, allSessions, project, base) => {
+    let session = initial;
+    let previewLines = await preview(session);
+    let subagentCount = await countSubagents(session);
+    action: while (true) {
+        const action = await selectAction(session, project, base, previewLines, subagentCount);
+        if (!action)
+            return 'back';
+        switch (action) {
+            case 'back':
+                return 'back';
+            case 'rename': {
+                const title = await promptTitle({
+                    Project: project,
+                    Base: base,
+                    ID: session.id,
+                    Date: session.date,
+                    Title: session.message,
+                });
+                if (!title)
+                    continue action;
+                await rename(session, title);
+                session.message = title;
+                continue action;
+            }
+            case 'open':
+                open(session);
+                continue action;
+            case 'stats': {
+                const sessionStats = await stats(session);
+                previewLines = formatStats(sessionStats);
+                continue action;
+            }
+            case 'fork': {
+                const defaultTitle = `Fork: ${session.message}`;
+                const forked = await fork(session, defaultTitle);
+                await rename(forked, defaultTitle);
+                const title = await promptTitle({
+                    Project: project,
+                    Base: base,
+                    ID: forked.id,
+                    Date: forked.date,
+                    Title: forked.message,
+                });
+                if (title) {
+                    await rename(forked, title);
+                    forked.message = title;
+                }
+                session = forked;
+                previewLines = await preview(session);
+                subagentCount = await countSubagents(session);
+                continue action;
+            }
+            case 'merge': {
+                const current = session;
+                const others = await selectMultiple(allSessions.filter((session) => session.id !== current.id), project, base);
+                if (!others || others.length === 0)
+                    continue action;
+                const all = [current, ...others];
+                const titles = all.map((session) => session.message);
+                const defaultTitle = `Merge: ${titles.join(', ')}`;
+                const merged = await merge(all, defaultTitle);
+                await rename(merged, defaultTitle);
+                const title = await promptTitle({
+                    Project: project,
+                    Base: base,
+                    ID: merged.id,
+                    Date: merged.date,
+                    Title: merged.message,
+                });
+                if (title) {
+                    await rename(merged, title);
+                    merged.message = title;
+                }
+                session = merged;
+                previewLines = await preview(session);
+                subagentCount = await countSubagents(session);
+                continue action;
+            }
+            case 'prune': {
+                const pruneStats = await analyze(session);
+                const selected = await selectPruneOptions(pruneStats, {
+                    Project: project,
+                    Base: base,
+                    ID: session.id,
+                    Date: session.date,
+                    Title: session.message,
+                });
+                if (selected === 'exit')
+                    return 'exit';
+                if (!selected)
+                    continue action;
+                await prune(session, {
+                    toolBlocks: selected.has('toolBlocks'),
+                    shortMessages: selected.has('shortMessages'),
+                    emptyMessages: selected.has('emptyMessages'),
+                    systemTags: selected.has('systemTags'),
+                    customTitles: selected.has('customTitles'),
+                });
+                previewLines = await preview(session);
+                subagentCount = await countSubagents(session);
+                continue action;
+            }
+            case 'trim': {
+                const { total, lines } = await extractMessages(session);
+                if (lines.length <= 1)
+                    continue action;
+                const selected = await selectTrimLine(lines, {
+                    Project: project,
+                    Base: base,
+                    ID: session.id,
+                    Date: session.date,
+                    Title: session.message,
+                });
+                if (selected === null)
+                    continue action;
+                const keepCount = selected + 1;
+                const removeCount = total - keepCount;
+                if (removeCount <= 0)
+                    continue action;
+                const confirmed = await promptConfirm(`Remove last ${removeCount} of ${total} messages?`);
+                if (!confirmed)
+                    continue action;
+                await trim(session, keepCount);
+                previewLines = await preview(session);
+                subagentCount = await countSubagents(session);
+                continue action;
+            }
+            case 'delete': {
+                const items = await targets(session);
+                const confirmed = await promptConfirm(`Delete ${items.join(' + ')}?`);
+                if (!confirmed)
+                    continue action;
+                await remove(session);
+                return 'back';
+            }
+            case 'exit':
+                return 'exit';
+        }
+    }
+};
 menu: while (true) {
     const { sessions, empty } = await listSessions(project, base);
     const choice = await selectMain(project, base, empty.length);
@@ -68,6 +211,30 @@ menu: while (true) {
         await cleanEmpty(empty);
         continue menu;
     }
+    if (choice === 'search') {
+        const fields = { Project: project, Base: base };
+        const query = await promptSearch(fields);
+        if (!query)
+            continue menu;
+        search: while (true) {
+            const { sessions: current } = await listSessions(project, base);
+            const results = await searchSessions(current, query);
+            if (results.length === 0) {
+                await showNoResults(query, fields);
+                continue menu;
+            }
+            const selected = await selectSearchResult(results, query, fields);
+            if (!selected)
+                continue menu;
+            if (selected === 'exit')
+                break menu;
+            const { sessions: fresh } = await listSessions(project, base);
+            const actionResult = await handleSession(selected, fresh, project, base);
+            if (actionResult === 'exit')
+                break menu;
+            continue search;
+        }
+    }
     list: while (true) {
         const { sessions: fresh } = await listSessions(project, base);
         const result = await select(fresh, project, base);
@@ -75,143 +242,9 @@ menu: while (true) {
             continue menu;
         if (result === 'exit')
             break menu;
-        let session = result;
-        let previewLines = await preview(session);
-        let subagentCount = await countSubagents(session);
-        action: while (true) {
-            const action = await selectAction(session, project, base, previewLines, subagentCount);
-            if (!action)
-                continue list;
-            switch (action) {
-                case 'back':
-                    continue list;
-                case 'rename': {
-                    const title = await promptTitle({
-                        Project: project,
-                        Base: base,
-                        ID: session.id,
-                        Date: session.date,
-                        Title: session.message,
-                    });
-                    if (!title)
-                        continue action;
-                    await rename(session, title);
-                    session.message = title;
-                    continue action;
-                }
-                case 'open':
-                    open(session);
-                    continue action;
-                case 'stats': {
-                    const sessionStats = await stats(session);
-                    previewLines = formatStats(sessionStats);
-                    continue action;
-                }
-                case 'fork': {
-                    const defaultTitle = `Fork: ${session.message}`;
-                    const forked = await fork(session, defaultTitle);
-                    await rename(forked, defaultTitle);
-                    const title = await promptTitle({
-                        Project: project,
-                        Base: base,
-                        ID: forked.id,
-                        Date: forked.date,
-                        Title: forked.message,
-                    });
-                    if (title) {
-                        await rename(forked, title);
-                        forked.message = title;
-                    }
-                    session = forked;
-                    previewLines = await preview(session);
-                    subagentCount = await countSubagents(session);
-                    continue action;
-                }
-                case 'merge': {
-                    const current = session;
-                    const others = await selectMultiple(fresh.filter((session) => session.id !== current.id), project, base);
-                    if (!others || others.length === 0)
-                        continue action;
-                    const all = [current, ...others];
-                    const titles = all.map((session) => session.message);
-                    const defaultTitle = `Merge: ${titles.join(', ')}`;
-                    const merged = await merge(all, defaultTitle);
-                    await rename(merged, defaultTitle);
-                    const title = await promptTitle({
-                        Project: project,
-                        Base: base,
-                        ID: merged.id,
-                        Date: merged.date,
-                        Title: merged.message,
-                    });
-                    if (title) {
-                        await rename(merged, title);
-                        merged.message = title;
-                    }
-                    session = merged;
-                    previewLines = await preview(session);
-                    subagentCount = await countSubagents(session);
-                    continue action;
-                }
-                case 'prune': {
-                    const stats = await analyze(session);
-                    const selected = await selectPruneOptions(stats, {
-                        Project: project,
-                        Base: base,
-                        ID: session.id,
-                        Date: session.date,
-                        Title: session.message,
-                    });
-                    if (selected === 'exit')
-                        break menu;
-                    if (!selected)
-                        continue action;
-                    await prune(session, {
-                        toolBlocks: selected.has('toolBlocks'),
-                        shortMessages: selected.has('shortMessages'),
-                        emptyMessages: selected.has('emptyMessages'),
-                        systemTags: selected.has('systemTags'),
-                    });
-                    previewLines = await preview(session);
-                    subagentCount = await countSubagents(session);
-                    continue action;
-                }
-                case 'trim': {
-                    const { total, lines } = await extractMessages(session);
-                    if (lines.length <= 1)
-                        continue action;
-                    const selected = await selectTrimLine(lines, {
-                        Project: project,
-                        Base: base,
-                        ID: session.id,
-                        Date: session.date,
-                        Title: session.message,
-                    });
-                    if (selected === null)
-                        continue action;
-                    const keepCount = selected + 1;
-                    const removeCount = total - keepCount;
-                    if (removeCount <= 0)
-                        continue action;
-                    const confirmed = await promptConfirm(`Remove last ${removeCount} of ${total} messages?`);
-                    if (!confirmed)
-                        continue action;
-                    await trim(session, keepCount);
-                    previewLines = await preview(session);
-                    subagentCount = await countSubagents(session);
-                    continue action;
-                }
-                case 'delete': {
-                    const items = await targets(session);
-                    const confirmed = await promptConfirm(`Delete ${items.join(' + ')}?`);
-                    if (!confirmed)
-                        continue action;
-                    await remove(session);
-                    continue list;
-                }
-                case 'exit':
-                    break menu;
-            }
-        }
+        const actionResult = await handleSession(result, fresh, project, base);
+        if (actionResult === 'exit')
+            break menu;
+        continue list;
     }
 }

package/lib/sessions/analyze-prune.js

@@ -52,11 +52,16 @@ export const analyze = async (session) => {
     let shortMessages = 0;
     let emptyMessages = 0;
     let systemTags = 0;
+    let titleLines = 0;
     for (const line of lines) {
         if (!line.trim())
             continue;
         try {
             const parsed = JSON.parse(line);
+            if (parsed.type === 'custom-title') {
+                titleLines++;
+                continue;
+            }
             if (!hasContent(parsed))
                 continue;
             const content = parsed.message.content;
@@ -73,5 +78,6 @@ export const analyze = async (session) => {
         }
         catch { }
     }
-    return { toolBlocks, shortMessages, emptyMessages, systemTags };
+    const customTitles = Math.max(0, titleLines - 1);
+    return { toolBlocks, shortMessages, emptyMessages, systemTags, customTitles };
 };

package/lib/sessions/extract-first-user-message.js

@@ -2,9 +2,12 @@ import { createReadStream } from 'node:fs';
 import { createInterface } from 'node:readline';
 import { parseLine } from './parse-line.js';
 const MIN_TEXT_LENGTH = 5;
+const normalizeText = (value) => value.replace(/\s+/g, ' ').trim();
 export const extractFirstUserMessage = (filePath) => new Promise((resolve) => {
     const stream = createReadStream(filePath, 'utf-8');
     const reader = createInterface({ input: stream, crlfDelay: Infinity });
+    let customTitle = '';
+    let fallback = '';
     const close = (value) => {
         resolve(value);
         reader.close();
@@ -16,27 +19,33 @@ export const extractFirstUserMessage = (filePath) => new Promise((resolve) => {
         const entry = parseLine(line);
         if (!entry)
             return;
+        if (entry.type === 'custom-title' && 'customTitle' in entry) {
+            customTitle = normalizeText(String(entry.customTitle));
+            return;
+        }
         if (entry.type === 'session_title' && 'title' in entry) {
-            close(String(entry.title)
-                .replace(/\s+/g, ' ')
-                .trim());
+            if (!fallback) {
+                fallback = normalizeText(String(entry.title));
+            }
             return;
         }
+        if (fallback)
+            return;
         if (entry.type !== 'user')
             return;
         const texts = entry.message?.content ?? [];
         for (const block of texts) {
             if (block.type !== 'text' || !block.text)
                 continue;
-            const text = block.text.replace(/\s+/g, ' ').trim();
+            const text = normalizeText(block.text);
             if (text.startsWith('<'))
                 continue;
             if (text.length <= MIN_TEXT_LENGTH)
                 continue;
-            close(text);
+            fallback = text;
             return;
         }
     });
-    reader.on('close', () => resolve(''));
+    reader.on('close', () => resolve(customTitle || fallback));
     stream.on('error', () => close(''));
 });

package/lib/sessions/search-sessions.d.ts

@@ -0,0 +1,2 @@
+import type { SearchMatch, Session } from '../types.js';
+export declare const searchSessions: (sessions: Session[], query: string) => Promise<SearchMatch[]>;

package/lib/sessions/search-sessions.js

@@ -0,0 +1,51 @@
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { parseLine } from './parse-line.js';
+const MIN_TEXT_LENGTH = 5;
+const searchSession = (session, query) => new Promise((resolve) => {
+    const stream = createReadStream(session.file, 'utf-8');
+    const reader = createInterface({ input: stream, crlfDelay: Infinity });
+    const matches = [];
+    const lower = query.toLowerCase();
+    const close = () => {
+        resolve(matches);
+        reader.close();
+        stream.destroy();
+    };
+    reader.on('line', (line) => {
+        if (!line.trim())
+            return;
+        const entry = parseLine(line);
+        if (!entry)
+            return;
+        if (entry.type !== 'user' && entry.type !== 'assistant')
+            return;
+        const texts = entry.message?.content ?? [];
+        for (const block of texts) {
+            if (block.type !== 'text' || !block.text)
+                continue;
+            const text = block.text
+                .replace(/\r?\n/g, ' ')
+                .trim()
+                .replace(/ {2,}/g, ' ');
+            if (text.startsWith('<'))
+                continue;
+            if (text.length <= MIN_TEXT_LENGTH)
+                continue;
+            if (!text.toLowerCase().includes(lower))
+                continue;
+            const tag = entry.type === 'user' ? '[ YOU ]' : '[ LLM ]';
+            matches.push(`${tag} ${text}`);
+            break;
+        }
+    });
+    reader.on('close', () => resolve(matches));
+    stream.on('error', () => close());
+});
+export const searchSessions = async (sessions, query) => {
+    const results = await Promise.all(sessions.map(async (session) => ({
+        session,
+        entries: await searchSession(session, query),
+    })));
+    return results.filter((result) => result.entries.length > 0);
+};

package/lib/types.d.ts

@@ -51,19 +51,11 @@ export type SessionIndex = {
     entries: IndexEntry[];
     [key: string]: unknown;
 };
-export type RenameCache = Record<string, string>;
 export type ContentBlock = {
     type: string;
     text?: string;
     [key: string]: unknown;
 };
-export type UserLine = {
-    type: 'user';
-    message: {
-        content: ContentBlock[];
-    };
-    [key: string]: unknown;
-};
 export type ModelName = 'opus' | 'sonnet' | 'haiku' | 'unknown';
 export type TokenUsage = {
     input: number;
@@ -91,10 +83,17 @@ export type PruneStats = {
     shortMessages: number;
     emptyMessages: number;
     systemTags: number;
+    customTitles: number;
 };
 export type PruneOptions = {
     toolBlocks: boolean;
     shortMessages: boolean;
     emptyMessages: boolean;
     systemTags: boolean;
+    customTitles: boolean;
+};
+export type SearchMatch = {
+    session: Session;
+    entries: string[];
 };
+export type ActionResult = 'back' | 'exit';

package/lib/ui/layout.d.ts

@@ -0,0 +1,16 @@
+import type { SelectOption } from '../types.js';
+export declare const PAGE_SIZE = 10;
+export declare const NEXT = -1;
+export declare const PREVIOUS = -2;
+export declare const EXIT = -3;
+export declare const CONFIRM = -4;
+export declare const CANCEL = -5;
+export declare const HEADER_MARGIN = 13;
+export declare const CLACK_PREFIX = 6;
+export declare const CHECKBOX_WIDTH = 2;
+export declare const EXIT_NUMBER = 0;
+export declare const CANCEL_NUMBER = 0;
+export declare const buildShortcuts: <T>(options: SelectOption<T>[]) => Map<string, number>;
+export declare const clear: () => void;
+export declare const printHeader: (fields: Record<string, string>) => void;
+export declare const showHeader: (fields?: Record<string, string>) => void;

package/lib/ui/layout.js

@@ -0,0 +1,46 @@
+import { dim } from '../helpers/ansi.js';
+import { getColumns } from '../helpers/get-columns.js';
+import { truncate } from '../helpers/truncate.js';
+export const PAGE_SIZE = 10;
+export const NEXT = -1;
+export const PREVIOUS = -2;
+export const EXIT = -3;
+export const CONFIRM = -4;
+export const CANCEL = -5;
+export const HEADER_MARGIN = 13; // terminal right-side safety margin
+export const CLACK_PREFIX = 6; // @clack/prompts left gutter width
+export const CHECKBOX_WIDTH = 2; // "☑ " / "☐ " prefix
+export const EXIT_NUMBER = 0;
+export const CANCEL_NUMBER = 0;
+export const buildShortcuts = (options) => {
+    const shortcuts = new Map();
+    for (let index = 0; index < options.length; index++) {
+        const option = options[index];
+        if (!option || option.number === undefined)
+            continue;
+        shortcuts.set(String(option.number), index);
+    }
+    return shortcuts;
+};
+export const clear = () => {
+    process.stdout.write('\x1b[2J\x1b[H');
+};
+export const printHeader = (fields) => {
+    clear();
+    const columns = getColumns();
+    const longest = Math.max(...Object.keys(fields).map((key) => key.length));
+    console.log();
+    for (const [key, value] of Object.entries(fields)) {
+        const padding = ' '.repeat(longest - key.length + 2);
+        const prefixLength = 2 + key.length + 1 + padding.length;
+        const available = columns - prefixLength - HEADER_MARGIN;
+        const truncated = available > 0 ? truncate(value, available) : value;
+        console.log(`  ${dim(`${key}:`)}${padding}${truncated}`);
+    }
+    console.log();
+};
+export const showHeader = (fields) => {
+    if (!fields)
+        return clear();
+    printHeader(fields);
+};

package/lib/ui/search.d.ts

@@ -0,0 +1,4 @@
+import type { SearchMatch, Session } from '../types.js';
+export declare const promptSearch: (fields?: Record<string, string>) => Promise<string | null>;
+export declare const showNoResults: (query: string, fields?: Record<string, string>) => Promise<void>;
+export declare const selectSearchResult: (results: SearchMatch[], query: string, fields?: Record<string, string>) => Promise<Session | "exit" | null>;

package/lib/ui/search.js

@@ -0,0 +1,157 @@
+import { isCancel, text } from '@clack/prompts';
+import { bold, colorize } from '../helpers/ansi.js';
+import { getColumns } from '../helpers/get-columns.js';
+import { truncate } from '../helpers/truncate.js';
+import { select as customSelect } from './custom-select.js';
+import { buildShortcuts, CANCEL, CLACK_PREFIX, clear, EXIT, EXIT_NUMBER, HEADER_MARGIN, NEXT, PAGE_SIZE, PREVIOUS, showHeader, } from './layout.js';
+const MATCH_COLOR = '38;5;208';
+const SESSION_ICON = '◌';
+const TITLE_MAX_LENGTH = 100;
+const INDENT = '  ';
+const INDENT_WIDTH = 2;
+export const promptSearch = async (fields) => {
+    showHeader(fields);
+    const result = await text({
+        message: 'Search query (Esc to cancel)',
+        placeholder: 'Type to search across all sessions...',
+    });
+    if (isCancel(result))
+        return null;
+    const trimmed = result.trim();
+    if (!trimmed)
+        return null;
+    return trimmed;
+};
+export const showNoResults = async (query, fields) => {
+    showHeader(fields);
+    await customSelect({
+        message: `No results for "${query}"`,
+        options: [
+            { label: '', value: 'back', disabled: true, separator: true },
+            { label: 'Back', value: 'back', icon: '←' },
+        ],
+        numbered: true,
+    });
+};
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const highlightMatch = (value, query) => {
+    const pattern = new RegExp(escapeRegExp(query), 'gi');
+    return value.replace(pattern, (match) => colorize(match, MATCH_COLOR));
+};
+const flattenMatches = (results) => {
+    const entries = [];
+    for (const result of results) {
+        for (const line of result.entries) {
+            entries.push({ session: result.session, text: line });
+        }
+    }
+    return entries;
+};
+export const selectSearchResult = async (results, query, fields) => {
+    const entries = flattenMatches(results);
+    let page = 0;
+    const total = Math.ceil(entries.length / PAGE_SIZE);
+    const matchCounts = new Map();
+    for (const result of results) {
+        matchCounts.set(result.session.id, result.entries.length);
+    }
+    pages: while (true) {
+        showHeader(fields);
+        const start = page * PAGE_SIZE;
+        const slice = entries.slice(start, start + PAGE_SIZE);
+        const columns = getColumns();
+        const labelMax = columns - CLACK_PREFIX - HEADER_MARGIN;
+        const options = [];
+        let lastSessionId = '';
+        for (let index = 0; index < slice.length; index++) {
+            const entry = slice[index];
+            if (!entry)
+                continue;
+            if (entry.session.id !== lastSessionId) {
+                if (options.length > 0) {
+                    options.push({
+                        label: '',
+                        value: EXIT,
+                        disabled: true,
+                        separator: true,
+                    });
+                }
+                lastSessionId = entry.session.id;
+                const count = matchCounts.get(entry.session.id) ?? 0;
+                const suffix = count === 1 ? 'match' : 'matches';
+                options.push({
+                    label: bold(truncate(entry.session.message, TITLE_MAX_LENGTH)),
+                    value: EXIT,
+                    disabled: true,
+                    icon: colorize(SESSION_ICON, MATCH_COLOR),
+                    hint: `${count} ${suffix} · ${entry.session.date}`,
+                });
+            }
+            const truncated = truncate(entry.text, labelMax - INDENT_WIDTH);
+            const highlighted = highlightMatch(truncated, query);
+            options.push({
+                label: `${INDENT}${highlighted}`,
+                value: start + index,
+            });
+        }
+        options.push({ label: '', value: EXIT, disabled: true, separator: true });
+        let actionNumber = 1;
+        if (page > 0) {
+            options.push({
+                label: 'Previous',
+                value: PREVIOUS,
+                icon: '←',
+                number: actionNumber,
+            });
+            actionNumber++;
+        }
+        if (page < total - 1) {
+            options.push({
+                label: 'Next',
+                value: NEXT,
+                icon: '→',
+                number: actionNumber,
+            });
+            actionNumber++;
+        }
+        options.push({ label: '', value: EXIT, disabled: true, separator: true });
+        options.push({
+            label: 'Back to menu',
+            value: EXIT,
+            icon: '☰',
+            number: actionNumber,
+        });
+        options.push({
+            label: 'Exit',
+            value: CANCEL,
+            icon: '✕',
+            iconColor: '38;5;204',
+            number: EXIT_NUMBER,
+        });
+        const result = await customSelect({
+            message: `Search results (${page + 1}/${total})`,
+            options,
+            shortcuts: buildShortcuts(options),
+        });
+        if (isCancel(result) || result === undefined)
+            return null;
+        if (result === EXIT)
+            return null;
+        if (result === CANCEL)
+            return 'exit';
+        if (result === NEXT) {
+            page++;
+            clear();
+            continue pages;
+        }
+        if (result === PREVIOUS) {
+            page--;
+            clear();
+            continue pages;
+        }
+        const selected = entries[result];
+        if (!selected)
+            continue pages;
+        return selected.session;
+    }
+};

package/lib/ui/select.d.ts

@@ -1,5 +1,5 @@
 import type { Action, PruneStats, Session } from '../types.js';
-export declare const selectMain: (project: string, base: string, emptyCount?: number) => Promise<"sessions" | "stats" | "clean" | null>;
+export declare const selectMain: (project: string, base: string, emptyCount?: number) => Promise<"sessions" | "search" | "stats" | "clean" | null>;
 export declare const select: (sessions: Session[], project: string, base: string) => Promise<Session | "exit" | null>;
 export declare const selectAction: (session: Session, project: string, base: string, previewLines: string[], subagentCount: number) => Promise<Action | null>;
 export declare const selectMultiple: (sessions: Session[], project: string, base: string) => Promise<Session[] | null>;

package/lib/ui/select.js

@@ -1,55 +1,13 @@
 import { isCancel, text } from '@clack/prompts';
-import { dim } from '../helpers/ansi.js';
 import { getColumns } from '../helpers/get-columns.js';
 import { truncate } from '../helpers/truncate.js';
 import { select as customSelect } from './custom-select.js';
-const PAGE_SIZE = 10;
-const NEXT = -1;
-const PREVIOUS = -2;
-const EXIT = -3;
-const CONFIRM = -4;
-const CANCEL = -5;
-const HEADER_MARGIN = 13; // terminal right-side safety margin
-const CLACK_PREFIX = 6; // @clack/prompts left gutter width
-const CHECKBOX_WIDTH = 2; // "☑ " / "☐ " prefix
-const EXIT_NUMBER = 0;
-const CANCEL_NUMBER = 0;
-const buildShortcuts = (options) => {
-    const shortcuts = new Map();
-    for (let index = 0; index < options.length; index++) {
-        const option = options[index];
-        if (!option || option.number === undefined)
-            continue;
-        shortcuts.set(String(option.number), index);
-    }
-    return shortcuts;
-};
-const clear = () => {
-    process.stdout.write('\x1b[2J\x1b[H');
-};
-const printHeader = (fields) => {
-    clear();
-    const columns = getColumns();
-    const longest = Math.max(...Object.keys(fields).map((key) => key.length));
-    console.log();
-    for (const [key, value] of Object.entries(fields)) {
-        const padding = ' '.repeat(longest - key.length + 2);
-        const prefixLength = 2 + key.length + 1 + padding.length;
-        const available = columns - prefixLength - HEADER_MARGIN;
-        const truncated = available > 0 ? truncate(value, available) : value;
-        console.log(`  ${dim(`${key}:`)}${padding}${truncated}`);
-    }
-    console.log();
-};
-const showHeader = (fields) => {
-    if (!fields)
-        return clear();
-    printHeader(fields);
-};
+import { buildShortcuts, CANCEL, CANCEL_NUMBER, CHECKBOX_WIDTH, CLACK_PREFIX, clear, CONFIRM, EXIT, EXIT_NUMBER, HEADER_MARGIN, NEXT, PAGE_SIZE, PREVIOUS, printHeader, showHeader, } from './layout.js';
 export const selectMain = async (project, base, emptyCount = 0) => {
     printHeader({ Project: project, Base: base });
     const options = [
         { label: 'Sessions', value: 'sessions' },
+        { label: 'Search', value: 'search' },
         { label: 'Stats', value: 'stats' },
     ];
     if (emptyCount > 0) {
@@ -299,21 +257,31 @@ export const selectPruneOptions = async (stats, fields) => {
         entries.push({
             key: 'toolBlocks',
             label: `${stats.toolBlocks} tool blocks`,
+            defaultSelected: true,
         });
     if (stats.emptyMessages > 0)
         entries.push({
             key: 'emptyMessages',
             label: `${stats.emptyMessages} empty messages`,
-        });
-    if (stats.shortMessages > 0)
-        entries.push({
-            key: 'shortMessages',
-            label: `${stats.shortMessages} short messages (<50 chars)`,
+            defaultSelected: true,
         });
     if (stats.systemTags > 0)
         entries.push({
             key: 'systemTags',
             label: `${stats.systemTags} system/IDE tags`,
+            defaultSelected: true,
+        });
+    if (stats.customTitles > 0)
+        entries.push({
+            key: 'customTitles',
+            label: `${stats.customTitles} old custom titles`,
+            defaultSelected: true,
+        });
+    if (stats.shortMessages > 0)
+        entries.push({
+            key: 'shortMessages',
+            label: `${stats.shortMessages} short messages (<50 chars)`,
+            defaultSelected: false,
         });
     if (entries.length === 0) {
         showHeader(fields);
@@ -332,8 +300,10 @@ export const selectPruneOptions = async (stats, fields) => {
     }
     const selected = new Set();
     let cursor;
-    for (let index = 0; index < entries.length; index++)
-        selected.add(index);
+    for (let index = 0; index < entries.length; index++) {
+        if (entries[index]?.defaultSelected)
+            selected.add(index);
+    }
     toggle: while (true) {
         showHeader(fields);
         const options = entries.map((entry, index) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessioner",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "✨ An interactive CLI to navigate and manage Claude Code sessions from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -27,7 +27,9 @@
     "start": "tsx src/bin/index.ts",
     "lint": "prettier --check .",
     "lint:fix": "prettier --write .",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "patch": "npm version patch --no-git-tag-version",
+    "prepublish": "npm run build"
   },
   "dependencies": {
     "@clack/core": "^1.0.1",

package/lib/helpers/rename-cache.d.ts

@@ -1,3 +0,0 @@
-import type { RenameCache } from '../types.js';
-export declare const readCache: () => Promise<RenameCache>;
-export declare const writeCache: (cache: RenameCache) => Promise<void>;

package/lib/helpers/rename-cache.js

@@ -1,18 +0,0 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const cacheDir = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '.cache');
-const cacheFile = join(cacheDir, 'renames.json');
-export const readCache = async () => {
-    try {
-        const raw = await readFile(cacheFile, 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return {};
-    }
-};
-export const writeCache = async (cache) => {
-    await mkdir(cacheDir, { recursive: true });
-    await writeFile(cacheFile, JSON.stringify(cache, null, 2));
-};