codedash-app 1.3.0 → 1.4.0

package/README.md

@@ -2,6 +2,8 @@
 
 Browser dashboard for Claude Code & Codex sessions. View, search, resume, and manage all your AI coding sessions.
 
+[Russian / Русский](docs/README_RU.md) | [Chinese / 中文](docs/README_ZH.md)
+
 https://github.com/user-attachments/assets/15c45659-365b-49f8-86a3-9005fa155ca6
 
 ![npm](https://img.shields.io/npm/v/codedash-app?style=flat-square) ![Node](https://img.shields.io/badge/node-%3E%3D16-green?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)
@@ -45,27 +47,18 @@ npx codedash-app stats              # show statistics
 - Related git commits shown per session
 - Auto-update notifications
 
-**Themes**
-- Dark (default), Light, System
+**Themes**: Dark (default), Light, System
 
-**Keyboard Shortcuts**
-- `/` focus search, `j/k` navigate, `Enter` open
-- `x` star, `d` delete, `s` select mode, `g` toggle groups
-- `r` refresh, `Escape` close panels
+**Keyboard Shortcuts**: `/` search, `j/k` navigate, `Enter` open, `x` star, `d` delete, `s` select, `g` group, `r` refresh, `Esc` close
 
 ## How It Works
 
-Reads session data from `~/.claude/` and `~/.codex/`:
-- `history.jsonl` — session index
-- `projects/*/<session-id>.jsonl` — conversation data
-- `sessions/` — Codex session files
-
-Zero dependencies. Everything runs on `localhost`.
+Reads session data from `~/.claude/` and `~/.codex/`. Zero dependencies. Everything runs on `localhost`.
 
 ## Requirements
 
 - Node.js >= 16
-- Claude Code or Codex CLI installed
+- Claude Code or Codex CLI
 - macOS / Linux / Windows
 
 ## License

package/bin/cli.js

@@ -2,6 +2,7 @@
 
 const { loadSessions } = require('../src/data');
 const { startServer } = require('../src/server');
+const { exportArchive, importArchive } = require('../src/migrate');
 
 const DEFAULT_PORT = 3847;
 const args = process.argv.slice(2);
@@ -56,6 +57,22 @@ switch (command) {
     break;
   }
 
+  case 'export': {
+    const outPath = args[1] || `codedash-export-${new Date().toISOString().slice(0,10)}.tar.gz`;
+    exportArchive(outPath);
+    break;
+  }
+
+  case 'import': {
+    const archivePath = args[1];
+    if (!archivePath) {
+      console.error('  Usage: codedash import <archive.tar.gz>');
+      process.exit(1);
+    }
+    importArchive(archivePath);
+    break;
+  }
+
   case 'version':
   case '-v':
   case '--version': {
@@ -75,6 +92,8 @@ switch (command) {
     codedash run [port] [--no-browser]   Start the dashboard server
     codedash list [limit]                List sessions in terminal
     codedash stats                       Show session statistics
+    codedash export [file.tar.gz]        Export all sessions to archive
+    codedash import <file.tar.gz>        Import sessions from archive
     codedash help                        Show this help
     codedash version                     Show version
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codedash-app",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Termius-style browser dashboard for Claude Code sessions. View, search, resume, and delete sessions with a dark-themed UI.",
   "bin": {
     "codedash": "./bin/cli.js"

package/src/frontend/app.js

@@ -602,10 +602,16 @@ function renderProjects(container, sessions) {
 
 // ── Activity Heatmap ───────────────────────────────────────────
 
+function localISO(date) {
+  var y = date.getFullYear();
+  var m = String(date.getMonth() + 1).padStart(2, '0');
+  var d = String(date.getDate()).padStart(2, '0');
+  return y + '-' + m + '-' + d;
+}
+
 function renderHeatmap(container) {
   var now = new Date();
-  var oneYearAgo = new Date(now);
-  oneYearAgo.setFullYear(oneYearAgo.getFullYear() - 1);
+  var oneYearAgo = new Date(now.getFullYear() - 1, now.getMonth(), now.getDate());
 
   // Count sessions per day
   var counts = {};
@@ -615,17 +621,16 @@ function renderHeatmap(container) {
     counts[d] = (counts[d] || 0) + 1;
   });
 
-  // Build day array for last 365 days
+  // Build day array — start from Sunday before oneYearAgo, end on Saturday after today
   var days = [];
   var d = new Date(oneYearAgo);
-  // Start from the most recent Sunday before or on oneYearAgo
-  d.setDate(d.getDate() - d.getDay());
+  d.setDate(d.getDate() - d.getDay()); // align to Sunday
 
   var endDate = new Date(now);
-  endDate.setDate(endDate.getDate() + (6 - endDate.getDay())); // end on Saturday
+  endDate.setDate(endDate.getDate() + (6 - endDate.getDay())); // align to Saturday
 
   while (d <= endDate) {
-    var iso = d.toISOString().slice(0, 10);
+    var iso = localISO(d);
     var count = counts[iso] || 0;
     var level = 0;
     if (count >= 6) level = 4;
@@ -633,8 +638,7 @@ function renderHeatmap(container) {
     else if (count >= 2) level = 2;
     else if (count >= 1) level = 1;
     days.push({ date: iso, count: count, level: level, day: d.getDay() });
-    d = new Date(d);
-    d.setDate(d.getDate() + 1);
+    d = new Date(d.getFullYear(), d.getMonth(), d.getDate() + 1);
   }
 
   // Build weeks (columns)
@@ -682,10 +686,10 @@ function renderHeatmap(container) {
   var streak = 0;
   var checkDate = new Date(now);
   while (true) {
-    var iso = checkDate.toISOString().slice(0, 10);
-    if (counts[iso] && counts[iso] > 0) {
+    var ciso = localISO(checkDate);
+    if (counts[ciso] && counts[ciso] > 0) {
       streak++;
-      checkDate.setDate(checkDate.getDate() - 1);
+      checkDate = new Date(checkDate.getFullYear(), checkDate.getMonth(), checkDate.getDate() - 1);
     } else {
       break;
     }

package/src/migrate.js

@@ -0,0 +1,185 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const CODEX_DIR = path.join(os.homedir(), '.codex');
+
+function exportArchive(outPath) {
+  const absOut = path.resolve(outPath);
+
+  // Build list of paths to include
+  const paths = [];
+
+  // Claude data
+  if (fs.existsSync(CLAUDE_DIR)) {
+    paths.push('.claude/history.jsonl');
+    paths.push('.claude/settings.json');
+
+    // All project session files
+    const projectsDir = path.join(CLAUDE_DIR, 'projects');
+    if (fs.existsSync(projectsDir)) {
+      paths.push('.claude/projects');
+    }
+
+    // Session env
+    const envDir = path.join(CLAUDE_DIR, 'session-env');
+    if (fs.existsSync(envDir)) {
+      paths.push('.claude/session-env');
+    }
+
+    // CLAUDE.md files
+    const claudeMd = path.join(CLAUDE_DIR, 'CLAUDE.md');
+    if (fs.existsSync(claudeMd)) {
+      paths.push('.claude/CLAUDE.md');
+    }
+
+    // Memory
+    const projectMemoryDirs = [];
+    if (fs.existsSync(projectsDir)) {
+      for (const proj of fs.readdirSync(projectsDir)) {
+        const memDir = path.join(projectsDir, proj, 'memory');
+        if (fs.existsSync(memDir)) {
+          projectMemoryDirs.push(path.join('.claude/projects', proj, 'memory'));
+        }
+      }
+    }
+  }
+
+  // Codex data
+  if (fs.existsSync(CODEX_DIR)) {
+    const codexHistory = path.join(CODEX_DIR, 'history.jsonl');
+    if (fs.existsSync(codexHistory)) {
+      paths.push('.codex/history.jsonl');
+    }
+    const codexSessions = path.join(CODEX_DIR, 'sessions');
+    if (fs.existsSync(codexSessions)) {
+      paths.push('.codex/sessions');
+    }
+    const codexConfig = path.join(CODEX_DIR, 'config.toml');
+    if (fs.existsSync(codexConfig)) {
+      paths.push('.codex/config.toml');
+    }
+  }
+
+  if (paths.length === 0) {
+    console.log('  Nothing to export. No ~/.claude or ~/.codex data found.');
+    return;
+  }
+
+  // Calculate sizes
+  let totalSize = 0;
+  let totalFiles = 0;
+  for (const p of paths) {
+    const full = path.join(os.homedir(), p);
+    if (fs.existsSync(full)) {
+      const stat = fs.statSync(full);
+      if (stat.isDirectory()) {
+        const output = execSync(`find "${full}" -type f | wc -l`, { encoding: 'utf8' }).trim();
+        totalFiles += parseInt(output) || 0;
+        const sizeOut = execSync(`du -sb "${full}" 2>/dev/null || du -sk "${full}"`, { encoding: 'utf8' }).trim();
+        totalSize += parseInt(sizeOut) || 0;
+      } else {
+        totalFiles++;
+        totalSize += stat.size;
+      }
+    }
+  }
+
+  console.log('');
+  console.log('  \x1b[36m\x1b[1mCodeDash Export\x1b[0m');
+  console.log(`  Files: ${totalFiles}`);
+  console.log(`  Paths: ${paths.length} directories/files`);
+  console.log(`  Includes: ${paths.map(p => p.split('/')[0]).filter((v,i,a) => a.indexOf(v) === i).join(', ')}`);
+  console.log('');
+  console.log('  Creating archive...');
+
+  // Create tar.gz from home directory
+  const pathArgs = paths.map(p => `"${p}"`).join(' ');
+  try {
+    execSync(`cd "${os.homedir()}" && tar -czf "${absOut}" ${pathArgs}`, {
+      stdio: 'pipe',
+    });
+    const archiveSize = fs.statSync(absOut).size;
+    const sizeMB = (archiveSize / 1048576).toFixed(1);
+    console.log(`  \x1b[32mDone!\x1b[0m ${absOut} (${sizeMB} MB)`);
+    console.log('');
+    console.log('  To import on another machine:');
+    console.log(`  \x1b[2mnpx codedash-app import ${path.basename(absOut)}\x1b[0m`);
+    console.log('');
+  } catch (e) {
+    console.error('  \x1b[31mFailed to create archive:\x1b[0m', e.message);
+    process.exit(1);
+  }
+}
+
+function importArchive(archivePath) {
+  const absPath = path.resolve(archivePath);
+
+  if (!fs.existsSync(absPath)) {
+    console.error(`  File not found: ${absPath}`);
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log('  \x1b[36m\x1b[1mCodeDash Import\x1b[0m');
+  console.log(`  Archive: ${absPath}`);
+
+  // List contents
+  const contents = execSync(`tar -tzf "${absPath}" | head -20`, { encoding: 'utf8' }).trim();
+  const lines = contents.split('\n');
+  const dirs = lines.map(l => l.split('/')[0]).filter((v,i,a) => a.indexOf(v) === i);
+
+  console.log(`  Contains: ${dirs.join(', ')}`);
+  console.log(`  Files: ${lines.length}${lines.length >= 20 ? '+' : ''}`);
+  console.log('');
+
+  // Check for existing data
+  const hasExisting = fs.existsSync(path.join(CLAUDE_DIR, 'history.jsonl')) ||
+                      fs.existsSync(path.join(CODEX_DIR, 'history.jsonl'));
+
+  if (hasExisting) {
+    console.log('  \x1b[33mWarning:\x1b[0m Existing session data found.');
+    console.log('  Import will \x1b[1mmerge\x1b[0m — existing files will be overwritten.');
+    console.log('');
+  }
+
+  // Extract to home directory
+  try {
+    execSync(`cd "${os.homedir()}" && tar -xzf "${absPath}"`, { stdio: 'pipe' });
+
+    // Merge history.jsonl if both exist
+    const importedHistory = path.join(CLAUDE_DIR, 'history.jsonl');
+    if (fs.existsSync(importedHistory)) {
+      // Deduplicate by sessionId+timestamp
+      const lines = fs.readFileSync(importedHistory, 'utf8').split('\n').filter(Boolean);
+      const seen = new Set();
+      const deduped = [];
+      for (const line of lines) {
+        try {
+          const d = JSON.parse(line);
+          const key = d.sessionId + ':' + d.timestamp;
+          if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(line);
+          }
+        } catch {
+          deduped.push(line);
+        }
+      }
+      fs.writeFileSync(importedHistory, deduped.join('\n') + '\n');
+    }
+
+    console.log('  \x1b[32mImport complete!\x1b[0m');
+    console.log('  Run \x1b[2mcodedash run\x1b[0m to see your sessions.');
+    console.log('');
+  } catch (e) {
+    console.error('  \x1b[31mFailed to import:\x1b[0m', e.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { exportArchive, importArchive };