@vitorcen/context-resume 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 vitorcen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# Context Resume CLI
+
+Context Resume lets you quickly resume work across Claude Code (`~/.claude`) and Codex CLI (`~/.codex`) by listing recent sessions for the current working directory, showing a detailed prompt history preview, and printing a ready-to-use bilingual (English/Chinese) resume prompt.
+
+## Features
+- **Dual-Panel View**: Split view for Claude and Codex sessions; use `TAB` to switch.
+- **Detailed Preview**: Shows a list of user prompts from the selected session (truncated to 50 chars) at the top.
+- **Configurable Limit**: Use `-n <count>` to control how many sessions to load per source.
+- **Bilingual Output**: Prints both English and Chinese prompts pointing to the session file.
+- **Privacy First**: Works entirely locally; no network calls.
+
+## Requirements
+- Node.js 18+ (tested with ESM build).
+
+## Installation
+```bash
+npm install
+npm run build
+npm link      # optional, to install the global `context` command
+```
+
+## Usage
+From any project directory you want to resume:
+```bash
+context           # Load default 10 sessions per source
+context -n 20     # Load 20 sessions per source
+```
+- Use **TAB** to switch between Claude and Codex panels.
+- Use **Arrow Keys** to select a session.
+- Preview at the top shows the sequence of user prompts.
+- Press **Enter** to print the resume prompts (with absolute paths) and exit.
+
+## How it works
+- **Claude**: Reads `~/.claude/projects/<encoded-path>/*.jsonl`.
+- **Codex**: Scans `~/.codex/sessions/**/*.jsonl`, filters by `cwd` metadata.
+- **Prompt Extraction**: Parses the session files to extract user inputs for the preview, giving you a quick summary of "what was I doing?".
+
+## Project layout
+- `src/index.tsx` – Entry point, handles CLI arguments.
+- `src/ui/app.tsx` – Ink UI with split panels and preview.
+- `src/adapters/index.ts` – File parsers and prompt extractors.
+
+## Limitations
+- Codex scanning involves globbing which might be slow on very large histories.

package/dist/adapters/index.js

@@ -0,0 +1,170 @@
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import os from 'os';
+// --- Claude Adapter ---
+function getClaudeEncodedPath(projectPath) {
+    // Claude encodes paths by replacing / and . with -
+    // e.g. /home/user/project -> -home-user-project
+    // e.g. /path/v1.0 -> -path-v1-0
+    return projectPath.replace(/[\/\.]/g, '-');
+}
+export async function getClaudeSessions(cwd, limit = 10) {
+    const homeDir = os.homedir();
+    const encodedPath = getClaudeEncodedPath(cwd);
+    const projectDir = path.join(homeDir, '.claude', 'projects', encodedPath);
+    if (!fs.existsSync(projectDir)) {
+        return [];
+    }
+    const files = glob.sync('*.jsonl', { cwd: projectDir });
+    // Sort by modification time (descending)
+    const sortedFiles = files.map((file) => {
+        const filePath = path.join(projectDir, file);
+        const stats = fs.statSync(filePath);
+        return { file, mtime: stats.mtimeMs, filePath };
+    })
+        .sort((a, b) => b.mtime - a.mtime)
+        .slice(0, limit);
+    const sessions = [];
+    for (const { filePath, file } of sortedFiles) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim() !== '');
+        if (lines.length === 0)
+            continue;
+        let firstUserMessage = 'New Session';
+        let fullContent = '';
+        const userPrompts = [];
+        for (const line of lines) {
+            try {
+                const data = JSON.parse(line);
+                // Try to find the first user message for the title
+                if (data.type === 'user' && data.message?.content) {
+                    const text = typeof data.message.content === 'string'
+                        ? data.message.content
+                        : (Array.isArray(data.message.content) ? data.message.content.map((c) => c.text || '').join(' ') : '');
+                    userPrompts.push(text);
+                    if (firstUserMessage === 'New Session') {
+                        firstUserMessage = text;
+                    }
+                }
+                // Accumulate content for preview (simplified)
+                if (data.type === 'user' && data.message?.content) {
+                    const text = typeof data.message.content === 'string' ? data.message.content : 'User Input...';
+                    fullContent += `User: ${text}\n`;
+                }
+                else if (data.message?.content && data.type !== 'user') { // Assistant or other
+                    const text = typeof data.message.content === 'string' ? data.message.content : 'Assistant Output...';
+                    fullContent += `Assistant: ${text}\n`;
+                }
+                else if (data.display) {
+                    fullContent += `System: ${data.display}\n`;
+                }
+            }
+            catch (e) {
+                // ignore parse errors
+            }
+        }
+        // Create preview: Start ... End
+        const preview = createPreview(fullContent);
+        const stats = fs.statSync(filePath);
+        sessions.push({
+            id: path.basename(file, '.jsonl'),
+            title: firstUserMessage.slice(0, 50) + (firstUserMessage.length > 50 ? '...' : ''),
+            preview,
+            userPrompts,
+            timestamp: stats.mtimeMs,
+            source: 'claude',
+            path: filePath
+        });
+    }
+    return sessions;
+}
+// --- Codex Adapter ---
+export async function getCodexSessions(cwd, limit = 10) {
+    const homeDir = os.homedir();
+    const sessionsDir = path.join(homeDir, '.codex', 'sessions');
+    if (!fs.existsSync(sessionsDir)) {
+        return [];
+    }
+    // We need to search deeply because of the date structure YYYY/MM/DD
+    // Optimization: Start searching from current year/month/day backwards could be better but glob is easier for MVP
+    // To avoid scanning ALL history, maybe we limit glob depth or just look at recent folders?
+    // For now, let's just glob all .jsonl and filter by CWD. In production, this should be optimized.
+    // Actually, reading all files to check CWD is slow.
+    // Strategy: Walk directories from today backwards?
+    // Let's use a simpler approach: glob all jsonl in the last 3 levels of directories
+    // Note: This might be slow if history is huge.
+    const files = glob.sync('**/*.jsonl', { cwd: sessionsDir, absolute: true });
+    // Filter by CWD and sort by time
+    const relevantFiles = [];
+    for (const filePath of files) {
+        // We need to peek at the first line to check CWD
+        try {
+            const fd = fs.openSync(filePath, 'r');
+            const buffer = Buffer.alloc(4096); // Read first 4KB
+            const bytesRead = fs.readSync(fd, buffer, 0, 4096, 0);
+            fs.closeSync(fd);
+            const chunk = buffer.toString('utf-8', 0, bytesRead);
+            const firstLine = chunk.split('\n')[0];
+            if (firstLine) {
+                const meta = JSON.parse(firstLine);
+                if (meta.type === 'session_meta' && meta.payload?.cwd === cwd) {
+                    const stats = fs.statSync(filePath);
+                    relevantFiles.push({ filePath, mtime: stats.mtimeMs });
+                }
+            }
+        }
+        catch (e) {
+            // ignore
+        }
+    }
+    const sortedFiles = relevantFiles
+        .sort((a, b) => b.mtime - a.mtime)
+        .slice(0, limit);
+    const sessions = [];
+    for (const { filePath, mtime } of sortedFiles) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim() !== '');
+        let firstUserMessage = 'New Session';
+        let fullContent = '';
+        const userPrompts = [];
+        for (const line of lines) {
+            try {
+                const data = JSON.parse(line);
+                // Codex User Input
+                if (data.type === 'response_item' && data.payload?.type === 'message' && data.payload.role === 'user') {
+                    const contentArr = data.payload.content || [];
+                    const text = contentArr.find((c) => c.type === 'input_text')?.text || '';
+                    userPrompts.push(text);
+                    if (firstUserMessage === 'New Session' && text) {
+                        firstUserMessage = text;
+                    }
+                    fullContent += `User: ${text}\n`;
+                }
+                // Codex Assistant Response (simplified logic)
+                // Codex format is a bit complex with chunks, we might just grab user inputs for now or simple responses if easily identifiable
+            }
+            catch (e) {
+                // ignore
+            }
+        }
+        const preview = createPreview(fullContent);
+        sessions.push({
+            id: path.basename(filePath, '.jsonl'),
+            title: firstUserMessage.slice(0, 50) + (firstUserMessage.length > 50 ? '...' : ''),
+            preview,
+            userPrompts,
+            timestamp: mtime,
+            source: 'codex',
+            path: filePath
+        });
+    }
+    return sessions;
+}
+function createPreview(content, maxLength = 500) {
+    if (content.length <= maxLength)
+        return content;
+    const start = content.slice(0, maxLength / 2);
+    const end = content.slice(content.length - (maxLength / 2));
+    return `${start}\n\n... [${content.length - maxLength} characters omitted] ...\n\n${end}`;
+}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Command } from 'commander';
+import { render } from 'ink';
+import App from './ui/app.js';
+const program = new Command();
+program
+    .name('context')
+    .description('Context Resume CLI')
+    .version('1.0.0', '-v, --version');
+program
+    .option('-n, --number <count>', 'Number of sessions to show per source (claude/codex)', '10')
+    .action(async (options) => {
+    const cwd = process.cwd();
+    const limit = parseInt(options.number, 10) || 10;
+    render(_jsx(App, { cwd: cwd, limit: limit }));
+});
+program.parse(process.argv);

package/dist/ui/app.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text, useInput, useApp } from 'ink';
+import SelectInput from 'ink-select-input';
+import { getClaudeSessions, getCodexSessions } from '../adapters/index.js';
+const App = ({ cwd, limit = 10 }) => {
+    const [claudeItems, setClaudeItems] = useState([]);
+    const [codexItems, setCodexItems] = useState([]);
+    const [activePanel, setActivePanel] = useState('claude');
+    const [activeClaudeItem, setActiveClaudeItem] = useState(null);
+    const [activeCodexItem, setActiveCodexItem] = useState(null);
+    const { exit } = useApp();
+    // Tab switching and Arrow Navigation
+    useInput((input, key) => {
+        if (key.tab) {
+            setActivePanel(prev => prev === 'claude' ? 'codex' : 'claude');
+        }
+        if (key.leftArrow && activePanel === 'codex') {
+            setActivePanel('claude');
+        }
+        if (key.rightArrow && activePanel === 'claude') {
+            setActivePanel('codex');
+        }
+    });
+    useEffect(() => {
+        const loadSessions = async () => {
+            const [claudeSessions, codexSessions] = await Promise.all([
+                getClaudeSessions(cwd, limit),
+                getCodexSessions(cwd, limit)
+            ]);
+            // Sort by timestamp desc
+            const sortFn = (a, b) => b.timestamp - a.timestamp;
+            const cItems = claudeSessions.sort(sortFn).map(s => ({
+                label: `${s.title} (${new Date(s.timestamp).toLocaleDateString()})`,
+                value: s.id,
+                session: s
+            }));
+            const cxItems = codexSessions.sort(sortFn).map(s => ({
+                label: `${s.title} (${new Date(s.timestamp).toLocaleDateString()})`,
+                value: s.id,
+                session: s
+            }));
+            setClaudeItems(cItems);
+            setCodexItems(cxItems);
+            if (cItems.length > 0)
+                setActiveClaudeItem(cItems[0]);
+            if (cxItems.length > 0)
+                setActiveCodexItem(cxItems[0]);
+        };
+        loadSessions();
+    }, [cwd, limit]);
+    const handleSelect = (item) => {
+        const selectedItem = item;
+        const englishPrompt = `Here's a context file ${selectedItem.session.path} from the user's previous operations. Analyze what the user was doing. Then use TodoWrite to list what might be incomplete, and what needs to be done next (if mentioned in the context), otherwise wait for user instructions.`;
+        const chinesePrompt = `这里有份上下文 ${selectedItem.session.path} ，是用户曾经的操作。你分析下用户在做什么。然后用TodoWrite列出可能没做完的事情，和接下来要的事情（如果上下文中有提到），如果没有就等待用户指令。`;
+        const output = `\n\n${englishPrompt}\n\n${chinesePrompt}\n\n`;
+        process.stdout.write(output);
+        exit();
+    };
+    const handleHighlightClaude = (item) => setActiveClaudeItem(item);
+    const handleHighlightCodex = (item) => setActiveCodexItem(item);
+    // Get current preview prompts
+    const currentItem = activePanel === 'claude' ? activeClaudeItem : activeCodexItem;
+    // Filter out empty prompts
+    const prompts = (currentItem?.session.userPrompts || []).filter(p => p && p.trim().length > 0);
+    // Truncate prompts logic
+    const previewText = prompts.map((p, i) => {
+        const clean = p.replace(/\n/g, ' ').trim();
+        const truncated = clean.length > 50 ? clean.slice(0, 50) + '...' : clean;
+        return `${i + 1}. ${truncated}`;
+    }).join('\n');
+    return (_jsxs(Box, { flexDirection: "column", height: 35, children: [_jsxs(Box, { height: 12, borderStyle: "single", flexDirection: "column", paddingX: 1, children: [_jsx(Text, { bold: true, underline: true, children: "Preview (User Prompts)" }), _jsx(Text, { children: previewText || 'Select a session to view prompts' })] }), _jsxs(Box, { flexDirection: "row", height: 20, children: [_jsxs(Box, { width: "50%", borderStyle: activePanel === 'claude' ? 'double' : 'single', flexDirection: "column", borderColor: activePanel === 'claude' ? 'green' : 'white', children: [_jsx(Text, { bold: true, underline: true, color: activePanel === 'claude' ? 'green' : 'white', children: "Claude Sessions" }), claudeItems.length === 0 ? (_jsx(Text, { children: "No sessions found." })) : (_jsx(SelectInput, { items: claudeItems, onSelect: handleSelect, onHighlight: handleHighlightClaude, isFocused: activePanel === 'claude' }))] }), _jsxs(Box, { width: "50%", borderStyle: activePanel === 'codex' ? 'double' : 'single', flexDirection: "column", borderColor: activePanel === 'codex' ? 'green' : 'white', children: [_jsx(Text, { bold: true, underline: true, color: activePanel === 'codex' ? 'green' : 'white', children: "Codex Sessions" }), codexItems.length === 0 ? (_jsx(Text, { children: "No sessions found." })) : (_jsx(SelectInput, { items: codexItems, onSelect: handleSelect, onHighlight: handleHighlightCodex, isFocused: activePanel === 'codex' }))] })] }), _jsx(Box, { marginTop: 0, children: _jsx(Text, { dimColor: true, children: "TAB/Arrows: Switch Panel | ENTER: Select | ESC: Exit" }) })] }));
+};
+export default App;

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@vitorcen/context-resume",
+  "version": "1.0.0",
+  "description": "Context Resume CLI - Browse and mutually restore the conversation history of Claude Code and Codex",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "context": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "tsc && node dist/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "codex",
+    "cli",
+    "context",
+    "history",
+    "resume",
+    "conversation",
+    "terminal"
+  ],
+  "author": "vitorcen",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "date-fns": "^4.1.0",
+    "glob": "^13.0.0",
+    "ink": "^6.5.1",
+    "ink-box": "^1.0.0",
+    "ink-select-input": "^6.2.0",
+    "react": "^19.2.1"
+  },
+  "devDependencies": {
+    "@types/glob": "^8.1.0",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}