sessioner 0.1.0 → 0.1.1

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
@@ -114,9 +112,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 +134,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 +143,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

@@ -171,6 +171,7 @@ menu: while (true) {
                         shortMessages: selected.has('shortMessages'),
                         emptyMessages: selected.has('emptyMessages'),
                         systemTags: selected.has('systemTags'),
+                        customTitles: selected.has('customTitles'),
                     });
                     previewLines = await preview(session);
                     subagentCount = await countSubagents(session);

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/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,12 @@ export type PruneStats = {
     shortMessages: number;
     emptyMessages: number;
     systemTags: number;
+    customTitles: number;
 };
 export type PruneOptions = {
     toolBlocks: boolean;
     shortMessages: boolean;
     emptyMessages: boolean;
     systemTags: boolean;
+    customTitles: boolean;
 };

package/lib/ui/select.js

@@ -299,21 +299,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 +342,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.1",
   "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));
-};