cursor-history 0.6.0 → 0.8.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Borui
+
+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

@@ -1,6 +1,115 @@
-# cursor-history
+# Cursor History
 
-CLI tool and library to browse, search, and export your Cursor AI chat history.
+<p align="center">
+  <img src="docs/logo.png" alt="cursor-history logo" width="200">
+</p>
+
+[![npm version](https://img.shields.io/npm/v/cursor-history.svg)](https://www.npmjs.com/package/cursor-history)
+[![npm downloads](https://img.shields.io/npm/dm/cursor-history.svg)](https://www.npmjs.com/package/cursor-history)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue.svg)](https://www.typescriptlang.org/)
+
+**The ultimate open-source tool for browsing, searching, exporting, and backing up your Cursor AI chat history.**
+
+A POSIX-style CLI tool that does one thing well: access your Cursor AI chat history. Built on Unix philosophy—simple, composable, and focused.
+
+```bash
+# Pipe-friendly: combine with other tools
+cursor-history list --json | jq '.[] | select(.messageCount > 10)'
+cursor-history export 1 | grep -i "api" | head -20
+cursor-history search "bug" --json | jq -r '.[].sessionId' | xargs -I {} cursor-history export {}
+```
+
+Never lose a conversation again. Whether you need to find that perfect code snippet from last week, migrate your history to a new machine, or create reliable backups of all your AI-assisted development sessions—cursor-history has you covered. Free, open-source, and built by the community for the community.
+
+## Example Output
+
+### List Sessions
+
+<pre>
+<span style="color: #888">cursor-history list</span>
+
+<span style="color: #5fd7ff">cursor-history</span> - Chat History Browser
+
+<span style="color: #5fd7ff">Sessions (showing 3 of 42):</span>
+
+  <span style="color: #af87ff">#1</span>  <span style="color: #87d787">12/26 09:15 AM</span>  <span style="color: #d7d787">cursor_chat_history</span>
+      <span style="color: #888">15 messages · Updated 2 min ago</span>
+      <span style="color: #fff">"Help me fix the migration path issue..."</span>
+
+  <span style="color: #af87ff">#2</span>  <span style="color: #87d787">12/25 03:22 PM</span>  <span style="color: #d7d787">my-react-app</span>
+      <span style="color: #888">8 messages · Updated 18 hours ago</span>
+      <span style="color: #fff">"Add authentication to the app..."</span>
+
+  <span style="color: #af87ff">#3</span>  <span style="color: #87d787">12/24 11:30 AM</span>  <span style="color: #d7d787">api-server</span>
+      <span style="color: #888">23 messages · Updated 2 days ago</span>
+      <span style="color: #fff">"Create REST endpoints for users..."</span>
+</pre>
+
+### Show Session Details
+
+<pre>
+<span style="color: #888">cursor-history show 1</span>
+
+<span style="color: #5fd7ff">Session #1</span> · <span style="color: #d7d787">cursor_chat_history</span>
+<span style="color: #888">15 messages · Created 12/26 09:15 AM</span>
+
+────────────────────────────────────────
+
+<span style="color: #87d787">You:</span> <span style="color: #888">09:15:23 AM</span>
+
+Help me fix the migration path issue in the codebase
+
+────────────────────────────────────────
+
+<span style="color: #af87ff">Assistant:</span> <span style="color: #888">09:15:45 AM</span>
+
+I'll help you fix the migration path issue. Let me first examine
+the relevant files.
+
+────────────────────────────────────────
+
+<span style="color: #d7af5f">Tool:</span> <span style="color: #888">09:15:46 AM</span>
+<span style="color: #d7af5f">🔧 Read File</span>
+   <span style="color: #888">File:</span> <span style="color: #5fd7ff">src/core/migrate.ts</span>
+   <span style="color: #888">Content:</span> <span style="color: #fff">export function migrateSession(sessionId: string...</span>
+   <span style="color: #87d787">Status: ✓ completed</span>
+
+────────────────────────────────────────
+
+<span style="color: #d7af5f">Tool:</span> <span style="color: #888">09:16:02 AM</span>
+<span style="color: #d7af5f">🔧 Edit File</span>
+   <span style="color: #888">File:</span> <span style="color: #5fd7ff">src/core/migrate.ts</span>
+
+   <span style="color: #87d787">```diff</span>
+<span style="color: #87d787">   + function transformPath(path: string): string {</span>
+<span style="color: #87d787">   +   return path.replace(sourcePrefix, destPrefix);</span>
+<span style="color: #87d787">   + }</span>
+   <span style="color: #87d787">```</span>
+
+   <span style="color: #87d787">Status: ✓ completed</span>
+
+────────────────────────────────────────
+
+<span style="color: #5f87d7">Thinking:</span> <span style="color: #888">09:16:02 AM</span>
+<span style="color: #5f87d7">💭</span> <span style="color: #888">Now I need to update the function to call transformPath
+   for each file reference in the bubble data...</span>
+
+────────────────────────────────────────
+
+<span style="color: #af87ff">Assistant:</span> <span style="color: #888">09:16:30 AM</span>
+
+I've added the path transformation logic. The migration will now
+update all file paths when moving sessions between workspaces.
+
+────────────────────────────────────────
+
+<span style="color: #ff5f5f">Error:</span> <span style="color: #888">09:17:01 AM</span>
+<span style="color: #ff5f5f">❌</span> <span style="color: #ff5f5f">Build failed: Cannot find module './utils'</span>
+
+────────────────────────────────────────
+</pre>
 
 ## Features
 
@@ -14,6 +123,8 @@ CLI tool and library to browse, search, and export your Cursor AI chat history.
   - Message timestamps
 - **Search** - Find conversations by keyword with highlighted matches
 - **Export** - Save sessions as Markdown or JSON files
+- **Migrate** - Move or copy sessions between workspaces (e.g., when renaming projects)
+- **Backup & Restore** - Create full backups of all chat history and restore when needed
 - **Cross-platform** - Works on macOS, Windows, and Linux
 
 ## Installation
@@ -128,6 +239,65 @@ cursor-history export --all -o ./exports/
 cursor-history export 1 --force
 ```
 
+### Migrate Sessions
+
+```bash
+# Move a single session to another workspace
+cursor-history migrate-session 1 /path/to/new/project
+
+# Move multiple sessions (comma-separated indices or IDs)
+cursor-history migrate-session 1,3,5 /path/to/project
+
+# Copy instead of move (keeps original)
+cursor-history migrate-session --copy 1 /path/to/project
+
+# Preview what would happen without making changes
+cursor-history migrate-session --dry-run 1 /path/to/project
+
+# Move all sessions from one workspace to another
+cursor-history migrate /old/project /new/project
+
+# Copy all sessions (backup)
+cursor-history migrate --copy /project /backup/project
+
+# Force merge with existing sessions at destination
+cursor-history migrate --force /old/project /existing/project
+```
+
+### Backup & Restore
+
+```bash
+# Create a backup of all chat history
+cursor-history backup
+
+# Create backup to specific file
+cursor-history backup -o ~/my-backup.zip
+
+# Overwrite existing backup
+cursor-history backup --force
+
+# List available backups
+cursor-history list-backups
+
+# List backups in a specific directory
+cursor-history list-backups -d /path/to/backups
+
+# Restore from a backup
+cursor-history restore ~/cursor-history-backups/backup.zip
+
+# Restore to a custom location
+cursor-history restore backup.zip --target /custom/cursor/data
+
+# Force overwrite existing data
+cursor-history restore backup.zip --force
+
+# View sessions from a backup without restoring
+cursor-history list --backup ~/backup.zip
+cursor-history show 1 --backup ~/backup.zip
+cursor-history search "query" --backup ~/backup.zip
+cursor-history export 1 --backup ~/backup.zip
+```
+
 ### Global Options
 
 ```bash
@@ -213,6 +383,79 @@ for (const match of results) {
 const markdown = exportSessionToMarkdown(0);
 ```
 
+### Migration API
+
+```typescript
+import { migrateSession, migrateWorkspace } from 'cursor-history';
+
+// Move a session to another workspace
+const results = migrateSession({
+  sessions: 3,  // index or ID
+  destination: '/path/to/new/project'
+});
+
+// Copy multiple sessions (keeps originals)
+const results = migrateSession({
+  sessions: [1, 3, 5],
+  destination: '/path/to/project',
+  mode: 'copy'
+});
+
+// Migrate all sessions between workspaces
+const result = migrateWorkspace({
+  source: '/old/project',
+  destination: '/new/project'
+});
+console.log(`Migrated ${result.successCount} sessions`);
+```
+
+### Backup API
+
+```typescript
+import {
+  createBackup,
+  restoreBackup,
+  validateBackup,
+  listBackups,
+  getDefaultBackupDir
+} from 'cursor-history';
+
+// Create a backup
+const result = await createBackup({
+  outputPath: '~/my-backup.zip',
+  force: true,
+  onProgress: (progress) => {
+    console.log(`${progress.phase}: ${progress.filesCompleted}/${progress.totalFiles}`);
+  }
+});
+console.log(`Backup created: ${result.backupPath}`);
+console.log(`Sessions: ${result.manifest.stats.sessionCount}`);
+
+// Validate a backup
+const validation = validateBackup('~/backup.zip');
+if (validation.status === 'valid') {
+  console.log('Backup is valid');
+} else if (validation.status === 'warnings') {
+  console.log('Backup has warnings:', validation.corruptedFiles);
+}
+
+// Restore from backup
+const restoreResult = restoreBackup({
+  backupPath: '~/backup.zip',
+  force: true
+});
+console.log(`Restored ${restoreResult.filesRestored} files`);
+
+// List available backups
+const backups = listBackups();  // Scans ~/cursor-history-backups/
+for (const backup of backups) {
+  console.log(`${backup.filename}: ${backup.manifest?.stats.sessionCount} sessions`);
+}
+
+// Read sessions from backup without restoring
+const sessions = listSessions({ backupPath: '~/backup.zip' });
+```
+
 ### Available Functions
 
 | Function | Description |
@@ -224,6 +467,13 @@ const markdown = exportSessionToMarkdown(0);
 | `exportSessionToMarkdown(index, config?)` | Export session to Markdown |
 | `exportAllSessionsToJson(config?)` | Export all sessions to JSON |
 | `exportAllSessionsToMarkdown(config?)` | Export all sessions to Markdown |
+| `migrateSession(config)` | Move/copy sessions to another workspace |
+| `migrateWorkspace(config)` | Move/copy all sessions between workspaces |
+| `createBackup(config?)` | Create full backup of all chat history |
+| `restoreBackup(config)` | Restore chat history from backup |
+| `validateBackup(path)` | Validate backup integrity |
+| `listBackups(directory?)` | List available backup files |
+| `getDefaultBackupDir()` | Get default backup directory path |
 | `getDefaultDataPath()` | Get platform-specific Cursor data path |
 
 ### Configuration Options
@@ -235,6 +485,7 @@ interface LibraryConfig {
   limit?: number;       // Pagination limit
   offset?: number;      // Pagination offset
   context?: number;     // Search context lines
+  backupPath?: string;  // Read from backup file instead of live data
 }
 ```
 
@@ -243,8 +494,14 @@ interface LibraryConfig {
 ```typescript
 import {
   listSessions,
+  createBackup,
   isDatabaseLockedError,
-  isDatabaseNotFoundError
+  isDatabaseNotFoundError,
+  isSessionNotFoundError,
+  isWorkspaceNotFoundError,
+  isBackupError,
+  isRestoreError,
+  isInvalidBackupError
 } from 'cursor-history';
 
 try {
@@ -254,6 +511,23 @@ try {
     console.error('Database locked - close Cursor and retry');
   } else if (isDatabaseNotFoundError(err)) {
     console.error('Cursor data not found');
+  } else if (isSessionNotFoundError(err)) {
+    console.error('Session not found');
+  } else if (isWorkspaceNotFoundError(err)) {
+    console.error('Workspace not found - open project in Cursor first');
+  }
+}
+
+// Backup-specific errors
+try {
+  const result = await createBackup();
+} catch (err) {
+  if (isBackupError(err)) {
+    console.error('Backup failed:', err.message);
+  } else if (isInvalidBackupError(err)) {
+    console.error('Invalid backup file');
+  } else if (isRestoreError(err)) {
+    console.error('Restore failed:', err.message);
   }
 }
 ```
@@ -300,6 +574,35 @@ This project uses GitHub Actions for automatic NPM publishing. To release a new
 2. Go to your GitHub repository settings → Secrets and variables → Actions
 3. Add a new repository secret named `NPM_TOKEN` with your NPM token
 
+## Contributing
+
+We welcome contributions from the community! Here's how you can help:
+
+### Reporting Issues
+
+- **Bug reports**: [Open an issue](https://github.com/S2thend/cursor_chat_history/issues/new) with steps to reproduce, expected vs actual behavior, and your environment (OS, Node.js version)
+- **Feature requests**: [Open an issue](https://github.com/S2thend/cursor_chat_history/issues/new) describing the feature and its use case
+
+### Submitting Pull Requests
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Run tests and linting (`npm test && npm run lint`)
+5. Commit your changes (`git commit -m 'Add my feature'`)
+6. Push to your fork (`git push origin feature/my-feature`)
+7. [Open a Pull Request](https://github.com/S2thend/cursor_chat_history/pulls)
+
+### Development Setup
+
+```bash
+git clone https://github.com/S2thend/cursor_chat_history.git
+cd cursor_chat_history
+npm install
+npm run build
+npm test
+```
+
 ## License
 
 MIT

package/dist/cli/commands/backup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Backup command - create full backup of all chat history
+ */
+import type { Command } from 'commander';
+/**
+ * Register the backup command
+ */
+export declare function registerBackupCommand(program: Command): void;
+//# sourceMappingURL=backup.d.ts.map

package/dist/cli/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsGzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoF5D"}

package/dist/cli/commands/backup.js

@@ -0,0 +1,168 @@
+/**
+ * Backup command - create full backup of all chat history
+ */
+import pc from 'picocolors';
+import { createBackup } from '../../core/backup.js';
+import { handleError, ExitCode } from '../errors.js';
+import { expandPath, contractPath } from '../../lib/platform.js';
+/**
+ * Format file size for display
+ */
+function formatSize(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Format duration for display
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/**
+ * T021: Progress display for backup command
+ */
+function displayProgress(progress) {
+    const phases = {
+        scanning: '🔍 Scanning for database files...',
+        'backing-up': '📦 Backing up databases...',
+        compressing: '🗜️  Compressing into zip...',
+        finalizing: '✨ Finalizing backup...',
+    };
+    const phaseText = phases[progress.phase];
+    const fileProgress = progress.totalFiles > 0
+        ? ` [${progress.filesCompleted}/${progress.totalFiles}]`
+        : '';
+    const currentFile = progress.currentFile ? ` ${pc.dim(progress.currentFile)}` : '';
+    // Clear line and print progress
+    process.stdout.write(`\r${phaseText}${fileProgress}${currentFile}`.padEnd(80));
+}
+/**
+ * Format backup result for JSON output
+ */
+function formatBackupResultJson(result) {
+    return JSON.stringify({
+        success: result.success,
+        backupPath: result.backupPath,
+        durationMs: result.durationMs,
+        ...(result.error && { error: result.error }),
+        manifest: result.manifest,
+    }, null, 2);
+}
+/**
+ * Format backup result for human-readable output
+ */
+function formatBackupResult(result) {
+    const lines = [];
+    if (result.success) {
+        lines.push(pc.green('✓ Backup created successfully!'));
+        lines.push('');
+        lines.push(`  ${pc.bold('Location:')} ${contractPath(result.backupPath)}`);
+        lines.push(`  ${pc.bold('Size:')} ${formatSize(result.manifest.stats.totalSize)}`);
+        lines.push(`  ${pc.bold('Sessions:')} ${result.manifest.stats.sessionCount}`);
+        lines.push(`  ${pc.bold('Workspaces:')} ${result.manifest.stats.workspaceCount}`);
+        lines.push(`  ${pc.bold('Files:')} ${result.manifest.files.length} database files`);
+        lines.push(`  ${pc.bold('Duration:')} ${formatDuration(result.durationMs)}`);
+    }
+    else {
+        lines.push(pc.red('✗ Backup failed'));
+        lines.push('');
+        if (result.error) {
+            lines.push(`  ${pc.bold('Error:')} ${result.error}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Register the backup command
+ */
+export function registerBackupCommand(program) {
+    program
+        .command('backup')
+        .description('Create a full backup of all Cursor chat history')
+        .option('-o, --output <path>', 'Output file path (default: ~/cursor-history-backups/<timestamp>.zip)')
+        .option('-f, --force', 'Overwrite existing backup file')
+        .action(async (options, command) => {
+        const globalOptions = command.parent?.opts();
+        const useJson = options.json ?? globalOptions?.json ?? false;
+        const customPath = options.dataPath ?? globalOptions?.dataPath;
+        try {
+            // Resolve output path if provided
+            const outputPath = options.output ? expandPath(options.output) : undefined;
+            // Show progress if not JSON mode
+            const onProgress = useJson ? undefined : displayProgress;
+            // Create backup
+            const result = await createBackup({
+                sourcePath: customPath ? expandPath(customPath) : undefined,
+                outputPath,
+                force: options.force ?? false,
+                onProgress,
+            });
+            // Clear progress line
+            if (!useJson) {
+                process.stdout.write('\r'.padEnd(80) + '\r');
+            }
+            // Handle different error cases with appropriate exit codes
+            if (!result.success) {
+                // T022: No data to backup
+                if (result.error?.includes('No Cursor data found')) {
+                    if (useJson) {
+                        console.log(formatBackupResultJson(result));
+                    }
+                    else {
+                        console.error(pc.yellow('No Cursor data found to backup.'));
+                        console.error(pc.dim('Make sure Cursor has been used and has chat history.'));
+                    }
+                    process.exit(ExitCode.USAGE_ERROR);
+                }
+                // T023: File exists without --force
+                if (result.error?.includes('already exists')) {
+                    if (useJson) {
+                        console.log(formatBackupResultJson(result));
+                    }
+                    else {
+                        console.error(pc.red('Backup file already exists.'));
+                        console.error(pc.dim('Use --force to overwrite.'));
+                    }
+                    process.exit(ExitCode.NOT_FOUND);
+                }
+                // T024: Insufficient disk space
+                if (result.error?.includes('Insufficient disk space')) {
+                    if (useJson) {
+                        console.log(formatBackupResultJson(result));
+                    }
+                    else {
+                        console.error(pc.red('Insufficient disk space for backup.'));
+                    }
+                    process.exit(ExitCode.IO_ERROR);
+                }
+                // Generic error
+                if (useJson) {
+                    console.log(formatBackupResultJson(result));
+                }
+                else {
+                    console.error(formatBackupResult(result));
+                }
+                process.exit(ExitCode.GENERAL_ERROR);
+            }
+            // Success
+            if (useJson) {
+                console.log(formatBackupResultJson(result));
+            }
+            else {
+                console.log(formatBackupResult(result));
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=backup.js.map

package/dist/cli/commands/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/cli/commands/backup.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoJ5D"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiM5D"}

package/dist/cli/commands/export.js

@@ -1,9 +1,11 @@
 /**
  * Export command - export chat sessions to files
  */
+import pc from 'picocolors';
 import { writeFileSync, existsSync, mkdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { getSession, listSessions, findWorkspaces } from '../../core/storage.js';
+import { validateBackup } from '../../core/backup.js';
 import { exportToMarkdown, exportToJson } from '../../core/parser.js';
 import { formatExportSuccess, formatExportResultJson } from '../formatters/index.js';
 import { SessionNotFoundError, FileExistsError, handleError, CliError, ExitCode, } from '../errors.js';
@@ -19,11 +21,33 @@ export function registerExportCommand(program) {
         .option('-f, --format <format>', 'Output format: md or json', 'md')
         .option('--force', 'Overwrite existing files')
         .option('-a, --all', 'Export all sessions')
+        .option('-b, --backup <path>', 'Export from backup file instead of live data')
         .action(async (indexArg, options, command) => {
         const globalOptions = command.parent?.opts();
         const useJson = options.json ?? globalOptions?.json ?? false;
         const customPath = options.dataPath ?? globalOptions?.dataPath;
         const format = options.format === 'json' ? 'json' : 'md';
+        const backupPath = options.backup ? expandPath(options.backup) : undefined;
+        // T037: Validate backup if exporting from backup
+        if (backupPath) {
+            const validation = validateBackup(backupPath);
+            if (validation.status === 'invalid') {
+                if (useJson) {
+                    console.log(JSON.stringify({ error: 'Invalid backup', errors: validation.errors }));
+                }
+                else {
+                    console.error(pc.red('Invalid backup file:'));
+                    for (const err of validation.errors) {
+                        console.error(pc.dim(`  ${err}`));
+                    }
+                }
+                process.exit(3);
+            }
+            if (validation.status === 'warnings' && !useJson) {
+                console.error(pc.yellow(`Warning: Backup has integrity issues (${validation.corruptedFiles.length} corrupted files)`));
+                console.error(pc.dim('Continuing with intact files...\n'));
+            }
+        }
         try {
             // Validate arguments
             if (!options.all && !indexArg) {
@@ -32,7 +56,7 @@ export function registerExportCommand(program) {
             const exported = [];
             if (options.all) {
                 // Export all sessions
-                const sessions = listSessions({ limit: 0, all: true }, customPath ? expandPath(customPath) : undefined);
+                const sessions = listSessions({ limit: 0, all: true }, customPath ? expandPath(customPath) : undefined, backupPath);
                 if (sessions.length === 0) {
                     throw new CliError('No sessions to export.', ExitCode.NOT_FOUND);
                 }
@@ -42,9 +66,13 @@ export function registerExportCommand(program) {
                 if (!existsSync(outputDir)) {
                     mkdirSync(outputDir, { recursive: true });
                 }
-                const workspaces = findWorkspaces(customPath ? expandPath(customPath) : undefined);
+                const workspaces = findWorkspaces(customPath ? expandPath(customPath) : undefined, backupPath);
+                // Show backup source indicator if exporting from backup
+                if (backupPath && !useJson) {
+                    console.log(pc.dim(`Exporting from backup: ${contractPath(backupPath)}\n`));
+                }
                 for (const summary of sessions) {
-                    const session = getSession(summary.index, customPath ? expandPath(customPath) : undefined);
+                    const session = getSession(summary.index, customPath ? expandPath(customPath) : undefined, backupPath);
                     if (!session)
                         continue;
                     const workspace = workspaces.find((w) => w.id === session.workspaceId);
@@ -74,12 +102,12 @@ export function registerExportCommand(program) {
                 if (isNaN(index) || index < 1) {
                     throw new CliError(`Invalid index: ${indexArg}. Must be a positive number.`, ExitCode.USAGE_ERROR);
                 }
-                const session = getSession(index, customPath ? expandPath(customPath) : undefined);
+                const session = getSession(index, customPath ? expandPath(customPath) : undefined, backupPath);
                 if (!session) {
-                    const sessions = listSessions({ limit: 0, all: true }, customPath ? expandPath(customPath) : undefined);
+                    const sessions = listSessions({ limit: 0, all: true }, customPath ? expandPath(customPath) : undefined, backupPath);
                     throw new SessionNotFoundError(index, sessions.length);
                 }
-                const workspaces = findWorkspaces(customPath ? expandPath(customPath) : undefined);
+                const workspaces = findWorkspaces(customPath ? expandPath(customPath) : undefined, backupPath);
                 const workspace = workspaces.find((w) => w.id === session.workspaceId);
                 const workspacePath = workspace?.path;
                 // Determine output path
@@ -103,6 +131,10 @@ export function registerExportCommand(program) {
                 if (dir !== '.' && !existsSync(dir)) {
                     mkdirSync(dir, { recursive: true });
                 }
+                // Show backup source indicator if exporting from backup
+                if (backupPath && !useJson) {
+                    console.log(pc.dim(`Exporting from backup: ${contractPath(backupPath)}\n`));
+                }
                 // Export
                 const content = format === 'json'
                     ? exportToJson(session, workspacePath)