sessioner 0.1.0

package/lib/ui/select.js

@@ -0,0 +1,459 @@
+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);
+};
+export const selectMain = async (project, base, emptyCount = 0) => {
+    printHeader({ Project: project, Base: base });
+    const options = [
+        { label: 'Sessions', value: 'sessions' },
+        { label: 'Stats', value: 'stats' },
+    ];
+    if (emptyCount > 0) {
+        options.push({
+            label: `Clean ${emptyCount} empty sessions`,
+            value: 'clean',
+        });
+    }
+    options.push({ label: '', value: 'exit', disabled: true, separator: true });
+    options.push({
+        label: 'Exit',
+        value: 'exit',
+        icon: '✕',
+        iconColor: '38;5;204',
+    });
+    const result = await customSelect({
+        message: 'Select an option',
+        options,
+        numbered: true,
+    });
+    if (isCancel(result) || result === undefined)
+        return null;
+    if (result === 'exit')
+        return null;
+    return result;
+};
+export const select = async (sessions, project, base) => {
+    let page = 0;
+    const total = Math.ceil(sessions.length / PAGE_SIZE);
+    pages: while (true) {
+        printHeader({ Project: project, Base: base });
+        const start = page * PAGE_SIZE;
+        const slice = sessions.slice(start, start + PAGE_SIZE);
+        const columns = getColumns();
+        const labelMax = columns - CLACK_PREFIX - HEADER_MARGIN;
+        const options = slice.map((session, index) => ({
+            label: truncate(session.message, labelMax),
+            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: `Select a session (${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;
+        }
+        return sessions[result] ?? null;
+    }
+};
+export const selectAction = async (session, project, base, previewLines, subagentCount) => {
+    const fields = {
+        Project: project,
+        Base: base,
+        ID: session.id,
+        Date: session.date,
+        Title: session.message,
+    };
+    if (subagentCount > 0)
+        fields.Subagents = String(subagentCount);
+    printHeader(fields);
+    for (const line of previewLines)
+        console.log(line);
+    if (previewLines.length > 0)
+        console.log();
+    const options = [
+        { label: 'Open', value: 'open' },
+        { label: 'Stats', value: 'stats' },
+        { label: 'Fork', value: 'fork' },
+        { label: 'Merge', value: 'merge' },
+        { label: 'Prune', value: 'prune' },
+        { label: 'Trim', value: 'trim' },
+        { label: 'Rename', value: 'rename' },
+        { label: 'Delete', value: 'delete' },
+        { label: '', value: 'back', disabled: true, separator: true },
+        { label: 'Back', value: 'back', icon: '←' },
+        { label: 'Exit', value: 'exit', icon: '✕', iconColor: '38;5;204' },
+    ];
+    const result = await customSelect({
+        message: 'Choose an action',
+        options,
+        numbered: true,
+    });
+    if (isCancel(result) || result === undefined)
+        return null;
+    return result;
+};
+export const selectMultiple = async (sessions, project, base) => {
+    const selected = new Set();
+    let page = 0;
+    const total = Math.ceil(sessions.length / PAGE_SIZE);
+    picks: while (true) {
+        printHeader({ Project: project, Base: base });
+        const start = page * PAGE_SIZE;
+        const slice = sessions.slice(start, start + PAGE_SIZE);
+        const columns = getColumns();
+        const labelMax = columns - CLACK_PREFIX - HEADER_MARGIN - CHECKBOX_WIDTH;
+        const options = slice.map((session, index) => {
+            const absolute = start + index;
+            const checkbox = selected.has(absolute) ? '☑' : '☐';
+            return {
+                label: `${checkbox} ${truncate(session.message, labelMax)}`,
+                value: absolute,
+            };
+        });
+        options.push({ label: '', value: CANCEL, 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: `Confirm (${selected.size})`,
+            value: CONFIRM,
+            icon: '✓',
+            number: actionNumber,
+        });
+        options.push({
+            label: 'Cancel',
+            value: CANCEL,
+            icon: '✕',
+            iconColor: '38;5;204',
+            number: CANCEL_NUMBER,
+        });
+        const result = await customSelect({
+            message: `Select sessions to merge (${page + 1}/${total})`,
+            options,
+            shortcuts: buildShortcuts(options),
+        });
+        if (isCancel(result) || result === undefined)
+            return null;
+        if (result === CANCEL)
+            return null;
+        if (result === NEXT) {
+            page++;
+            clear();
+            continue picks;
+        }
+        if (result === PREVIOUS) {
+            page--;
+            clear();
+            continue picks;
+        }
+        if (result === CONFIRM) {
+            if (selected.size === 0)
+                continue picks;
+            return [...selected]
+                .map((index) => sessions[index])
+                .filter((session) => session !== undefined);
+        }
+        if (selected.has(result)) {
+            selected.delete(result);
+        }
+        else {
+            selected.add(result);
+        }
+        clear();
+    }
+};
+export const promptTitle = async (fields) => {
+    showHeader(fields);
+    const result = await text({
+        message: 'New title (Esc to cancel)',
+        placeholder: 'Type the new session title...',
+    });
+    if (isCancel(result))
+        return null;
+    return result;
+};
+export const promptConfirm = async (message) => {
+    const result = await customSelect({
+        message,
+        options: [
+            { label: 'Yes', value: true },
+            { label: 'No', value: false },
+        ],
+        numbered: true,
+    });
+    if (isCancel(result) || result === undefined)
+        return null;
+    return result;
+};
+export const selectPruneOptions = async (stats, fields) => {
+    const entries = [];
+    if (stats.toolBlocks > 0)
+        entries.push({
+            key: 'toolBlocks',
+            label: `${stats.toolBlocks} tool blocks`,
+        });
+    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)`,
+        });
+    if (stats.systemTags > 0)
+        entries.push({
+            key: 'systemTags',
+            label: `${stats.systemTags} system/IDE tags`,
+        });
+    if (entries.length === 0) {
+        showHeader(fields);
+        const result = await customSelect({
+            message: 'Nothing to prune',
+            options: [
+                { label: '', value: 'back', disabled: true, separator: true },
+                { label: 'Back', value: 'back', icon: '←' },
+                { label: 'Exit', value: 'exit', icon: '✕', iconColor: '38;5;204' },
+            ],
+            numbered: true,
+        });
+        if (result === 'exit')
+            return 'exit';
+        return null;
+    }
+    const selected = new Set();
+    let cursor;
+    for (let index = 0; index < entries.length; index++)
+        selected.add(index);
+    toggle: while (true) {
+        showHeader(fields);
+        const options = entries.map((entry, index) => {
+            const checkbox = selected.has(index) ? '☑' : '☐';
+            return { label: `${checkbox} ${entry.label}`, value: index };
+        });
+        options.push({ label: '', value: CANCEL, disabled: true, separator: true });
+        options.push({
+            label: `Confirm (${selected.size})`,
+            value: CONFIRM,
+            icon: '✓',
+            number: 1,
+        });
+        options.push({
+            label: 'Cancel',
+            value: CANCEL,
+            icon: '✕',
+            iconColor: '38;5;204',
+            number: CANCEL_NUMBER,
+        });
+        const result = await customSelect({
+            message: 'Select what to prune',
+            options,
+            initialValue: cursor,
+            shortcuts: buildShortcuts(options),
+        });
+        if (isCancel(result) || result === undefined)
+            return null;
+        if (result === CANCEL)
+            return null;
+        if (result === CONFIRM) {
+            if (selected.size === 0)
+                continue toggle;
+            return new Set([...selected]
+                .map((index) => entries[index]?.key)
+                .filter((key) => key !== undefined));
+        }
+        if (selected.has(result)) {
+            selected.delete(result);
+        }
+        else {
+            selected.add(result);
+        }
+        cursor = result;
+    }
+};
+export const selectTrimLine = async (messages, fields) => {
+    let page = 0;
+    const total = Math.ceil(messages.length / PAGE_SIZE);
+    pages: while (true) {
+        showHeader(fields);
+        const start = page * PAGE_SIZE;
+        const slice = messages.slice(start, start + PAGE_SIZE);
+        const columns = getColumns();
+        const labelMax = columns - CLACK_PREFIX - HEADER_MARGIN;
+        const options = slice.map(([ordinal, label]) => ({
+            label: truncate(label, labelMax),
+            value: ordinal,
+        }));
+        options.push({ label: '', value: CANCEL, 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: 'Cancel',
+            value: CANCEL,
+            icon: '✕',
+            iconColor: '38;5;204',
+            number: CANCEL_NUMBER,
+        });
+        const result = await customSelect({
+            message: `Select last message to keep (${page + 1}/${total})`,
+            options,
+            shortcuts: buildShortcuts(options),
+        });
+        if (isCancel(result) || result === undefined)
+            return null;
+        if (result === CANCEL)
+            return null;
+        if (result === NEXT) {
+            page++;
+            clear();
+            continue pages;
+        }
+        if (result === PREVIOUS) {
+            page--;
+            clear();
+            continue pages;
+        }
+        return result;
+    }
+};
+export const showProjectStats = async (lines, fields) => {
+    printHeader(fields);
+    for (const line of lines)
+        console.log(line);
+    if (lines.length > 0)
+        console.log();
+    await customSelect({
+        message: 'Stats',
+        options: [
+            { label: '', value: 'back', disabled: true, separator: true },
+            { label: 'Back', value: 'back', icon: '←' },
+        ],
+        numbered: true,
+    });
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "sessioner",
+  "version": "0.1.0",
+  "description": "✨ An interactive CLI to navigate and manage Claude Code sessions from the terminal.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "sessioner": "lib/bin/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wellwelwel/sessioner.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wellwelwel/sessioner/issues"
+  },
+  "author": "https://github.com/wellwelwel",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/wellwelwel"
+  },
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "rm -rf lib && tsc",
+    "start": "tsx src/bin/index.ts",
+    "lint": "prettier --check .",
+    "lint:fix": "prettier --write .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/core": "^1.0.1",
+    "@clack/prompts": "^1.0.1"
+  },
+  "devDependencies": {
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
+    "@types/node": "^25.3.1",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "claude",
+    "session",
+    "sessions",
+    "claude-code",
+    "cli",
+    "terminal",
+    "interactive",
+    "management",
+    "navigation",
+    "session-viewer",
+    "claude-stats",
+    "claude-session-viewer",
+    "claude-session-stats",
+    "claude-opus",
+    "claude-sonnet",
+    "claude-haiku"
+  ]
+}