codedash-app 4.2.1 → 5.0.0

package/bin/cli.js

@@ -4,6 +4,7 @@ const { loadSessions, searchFullText, getSessionPreview, computeSessionCost } =
 const { startServer } = require('../src/server');
 const { exportArchive, importArchive } = require('../src/migrate');
 const { convertSession } = require('../src/convert');
+const { generateHandoff, quickHandoff } = require('../src/handoff');
 
 const DEFAULT_PORT = 3847;
 const args = process.argv.slice(2);
@@ -131,6 +132,70 @@ switch (command) {
     break;
   }
 
+  case 'handoff':
+  case 'continue': {
+    const sid = args[1];
+    const target = args[2] || 'any';
+    const verbFlag = args.find(a => a.startsWith('--verbosity='));
+    const verbosity = verbFlag ? verbFlag.split('=')[1] : 'standard';
+    const outFlag = args.find(a => a.startsWith('--out='));
+
+    if (!sid) {
+      console.log(`
+  \x1b[36m\x1b[1mHandoff session to another agent\x1b[0m
+
+  Usage: codedash handoff <session-id> [target] [options]
+
+  Generates a context document for continuing a session in another tool.
+
+  Targets: claude, codex, opencode, any (default)
+  Options:
+    --verbosity=minimal|standard|verbose|full
+    --out=file.md  (save to file instead of stdout)
+
+  Examples:
+    codedash handoff 13ae5748                    Print handoff doc
+    codedash handoff 13ae5748 codex              For Codex specifically
+    codedash handoff 13ae5748 --verbosity=full   Include more context
+    codedash handoff 13ae5748 --out=handoff.md   Save to file
+
+  Quick handoff (latest session):
+    codedash handoff claude codex                Latest Claude → Codex
+`);
+      break;
+    }
+
+    // Check if sid is a tool name (quick handoff)
+    let result;
+    if (['claude', 'codex', 'opencode'].includes(sid)) {
+      result = quickHandoff(sid, target, { verbosity });
+    } else {
+      const allH = loadSessions();
+      const match = allH.find(s => s.id === sid || s.id.startsWith(sid));
+      if (!match) {
+        console.error(`  Session not found: ${sid}`);
+        process.exit(1);
+      }
+      result = generateHandoff(match.id, match.project, { verbosity, target });
+    }
+
+    if (!result.ok) {
+      console.error(`  \x1b[31mError:\x1b[0m ${result.error}\n`);
+      process.exit(1);
+    }
+
+    if (outFlag) {
+      const outPath = outFlag.split('=')[1];
+      require('fs').writeFileSync(outPath, result.markdown);
+      console.log(`\n  \x1b[32mHandoff saved to ${outPath}\x1b[0m`);
+      console.log(`  Source: ${result.session.tool} (${result.session.id.slice(0, 12)})`);
+      console.log(`  Messages: ${result.session.messages}\n`);
+    } else {
+      console.log(result.markdown);
+    }
+    break;
+  }
+
   case 'convert': {
     const sid = args[1];
     const target = args[2]; // 'claude' or 'codex'
@@ -253,6 +318,7 @@ switch (command) {
     codedash show <session-id>           Show session details + messages
     codedash list [limit]                List sessions in terminal
     codedash stats                       Show session statistics
+    codedash handoff <id> [target]       Generate handoff document
     codedash convert <id> <format>       Convert session (claude/codex)
     codedash export [file.tar.gz]        Export all sessions to archive
     codedash import <file.tar.gz>        Import sessions from archive

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codedash-app",
-  "version": "4.2.1",
-  "description": "Termius-style browser dashboard for Claude Code sessions. View, search, resume, and delete sessions with a dark-themed UI.",
+  "version": "5.0.0",
+  "description": "Dashboard + CLI for Claude Code, Codex & OpenCode sessions. View, search, resume, convert, handoff between agents.",
   "bin": {
     "codedash": "./bin/cli.js"
   },
@@ -31,6 +31,6 @@
   "author": "Valerii Kovalskii",
   "license": "MIT",
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   }
 }

package/src/frontend/app.js

@@ -1091,6 +1091,7 @@ async function openDetail(s) {
     infoHtml += '<button class="launch-btn btn-secondary" onclick="exportMd(\'' + s.id + '\',\'' + escHtml(s.project || '') + '\')">Export MD</button>';
     var convertTarget = s.tool === 'codex' ? 'claude' : 'codex';
     infoHtml += '<button class="launch-btn btn-secondary" onclick="convertTo(\'' + s.id + '\',\'' + escHtml(s.project || '') + '\',\'' + convertTarget + '\')">Convert to ' + convertTarget + '</button>';
+    infoHtml += '<button class="launch-btn btn-secondary" onclick="downloadHandoff(\'' + s.id + '\',\'' + escHtml(s.project || '') + '\')">Handoff</button>';
   }
   infoHtml += '<button class="star-btn detail-star' + (isStarred ? ' active' : '') + '" onclick="toggleStar(\'' + s.id + '\')">&#9733; ' + (isStarred ? 'Starred' : 'Star') + '</button>';
   infoHtml += '<button class="launch-btn btn-delete" onclick="showDeleteConfirm(\'' + s.id + '\',\'' + escHtml(s.project || '') + '\')">Delete</button>';
@@ -1813,6 +1814,12 @@ async function convertTo(sessionId, project, targetFormat) {
   }
 }
 
+// ── Handoff ───────────────────────────────────────────────────
+
+function downloadHandoff(sessionId, project) {
+  window.open('/api/handoff/' + sessionId + '?project=' + encodeURIComponent(project) + '&verbosity=standard');
+}
+
 // ── Install agents ────────────────────────────────────────────
 
 var AGENT_INSTALL = {

package/src/handoff.js

@@ -0,0 +1,117 @@
+'use strict';
+
+const { loadSessions, loadSessionDetail, getSessionPreview, findSessionFile, computeSessionCost } = require('./data');
+
+// ── Handoff document generator ────────────────────────────
+
+const VERBOSITY = {
+  minimal: 3,
+  standard: 10,
+  verbose: 20,
+  full: 50,
+};
+
+function generateHandoff(sessionId, project, options) {
+  options = options || {};
+  const verbosity = options.verbosity || 'standard';
+  const target = options.target || 'any';
+  const msgLimit = VERBOSITY[verbosity] || 10;
+
+  // Find session
+  const sessions = loadSessions();
+  const session = sessions.find(s => s.id === sessionId || s.id.startsWith(sessionId));
+  if (!session) return { ok: false, error: 'Session not found' };
+
+  // Load messages
+  const detail = loadSessionDetail(session.id, session.project || project);
+  const messages = (detail.messages || []).slice(-msgLimit);
+  const cost = computeSessionCost(session.id, session.project || project);
+
+  // Build handoff document
+  const lines = [];
+  lines.push('# Session Handoff');
+  lines.push('');
+  lines.push(`> Transferred from **${session.tool}** session \`${session.id}\``);
+  lines.push(`> Project: \`${session.project_short || session.project || 'unknown'}\``);
+  lines.push(`> Started: ${session.first_time} | Last active: ${session.last_time}`);
+  lines.push(`> Messages: ${session.detail_messages || session.messages} | Cost: $${cost.cost.toFixed(2)} (${cost.model || 'unknown'})`);
+  lines.push('');
+
+  // Summary of what was being worked on
+  if (messages.length > 0) {
+    // First user message = original task
+    const firstUser = messages.find(m => m.role === 'user');
+    if (firstUser) {
+      lines.push('## Original Task');
+      lines.push('');
+      lines.push(firstUser.content.slice(0, 500));
+      lines.push('');
+    }
+
+    // Last assistant message = current state
+    const lastAssistant = [...messages].reverse().find(m => m.role === 'assistant');
+    if (lastAssistant) {
+      lines.push('## Current State (last assistant response)');
+      lines.push('');
+      lines.push(lastAssistant.content.slice(0, 1000));
+      lines.push('');
+    }
+
+    // Last user message = latest request
+    const lastUser = [...messages].reverse().find(m => m.role === 'user');
+    if (lastUser && lastUser !== firstUser) {
+      lines.push('## Latest Request');
+      lines.push('');
+      lines.push(lastUser.content.slice(0, 500));
+      lines.push('');
+    }
+  }
+
+  // Full recent conversation
+  lines.push('## Recent Conversation');
+  lines.push('');
+  for (const m of messages) {
+    const role = m.role === 'user' ? 'User' : 'Assistant';
+    lines.push(`### ${role}`);
+    lines.push('');
+    lines.push(m.content.slice(0, verbosity === 'full' ? 3000 : 1000));
+    lines.push('');
+  }
+
+  // Instructions for target agent
+  lines.push('## Instructions for New Agent');
+  lines.push('');
+  lines.push('This is a handoff from a previous coding session. Please:');
+  lines.push('1. Read the context above to understand what was being worked on');
+  lines.push('2. Continue from where the previous agent left off');
+  lines.push('3. Do not repeat work that was already completed');
+  if (session.project) {
+    lines.push(`4. The project directory is: \`${session.project}\``);
+  }
+  lines.push('');
+
+  const markdown = lines.join('\n');
+
+  return {
+    ok: true,
+    markdown: markdown,
+    session: {
+      id: session.id,
+      tool: session.tool,
+      project: session.project_short || session.project,
+      messages: messages.length,
+    },
+    target: target,
+  };
+}
+
+// ── Quick handoff: find latest session and generate ───────
+
+function quickHandoff(sourceTool, target, options) {
+  const sessions = loadSessions();
+  const source = sessions.find(s => s.tool === sourceTool);
+  if (!source) return { ok: false, error: `No ${sourceTool} sessions found` };
+  return generateHandoff(source.id, source.project, { ...options, target });
+}
+
+module.exports = { generateHandoff, quickHandoff, VERBOSITY };

package/src/server.js

@@ -6,6 +6,7 @@ const { exec } = require('child_process');
 const { loadSessions, loadSessionDetail, deleteSession, getGitCommits, exportSessionMarkdown, getSessionPreview, searchFullText, getActiveSessions, getSessionReplay, getCostAnalytics, computeSessionCost } = require('./data');
 const { detectTerminals, openInTerminal, focusTerminalByPid } = require('./terminals');
 const { convertSession } = require('./convert');
+const { generateHandoff } = require('./handoff');
 const { CHANGELOG } = require('./changelog');
 const { getHTML } = require('./html');
 
@@ -112,6 +113,23 @@ function startServer(port, openBrowser = true) {
       json(res, active);
     }
 
+    // ── Handoff document ───────────────────
+    else if (req.method === 'GET' && pathname.startsWith('/api/handoff/')) {
+      const sessionId = pathname.split('/').pop();
+      const project = parsed.searchParams.get('project') || '';
+      const verbosity = parsed.searchParams.get('verbosity') || 'standard';
+      const result = generateHandoff(sessionId, project, { verbosity });
+      if (result.ok) {
+        res.writeHead(200, {
+          'Content-Type': 'text/markdown; charset=utf-8',
+          'Content-Disposition': `attachment; filename="handoff-${sessionId.slice(0, 8)}.md"`,
+        });
+        res.end(result.markdown);
+      } else {
+        json(res, result, 404);
+      }
+    }
+
     // ── Convert session ─────────────────────
     else if (req.method === 'POST' && pathname === '/api/convert') {
       readBody(req, body => {