LOFT Session Archiver - VS Code Extension

Archive Claude session files from a project directory with automatic error cleanup using an intuitive GUI. When ZIP mode is enabled, the cleaned folder is removed after archiving so only the ZIP submission artifact remains.

🎯 Features

Session Archiver (Primary Feature)

Select a project directory, auto-detect the session files, and create ZIP backups with automatic error cleanup for Aquila submission.

Key Capabilities:

• 📦 Archive sessions to ZIP files for Aquila submission
• 📂 Auto-detect sessions for the selected project directory from ~/.claude/projects/
• 🧹 Always removes API errors, authentication failures, and synthetic error messages
• 📊 Real-time statistics and progress tracking
• 🔄 Process multiple session files and directories
• 💾 Compress archives by default (configurable)
• 🗑️ Remove the cleaned folder after ZIP creation so the archive remains
• 👁️ Dry-run preview mode for cleanup operations
• 🎨 Native VS Code theming support

Quick Start: QUICKSTART.md

🚀 Installation

From Extension Marketplace

Search for "LOFT" in VS Code Extensions

📖 Usage

Archive Sessions

1. Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
2. Search for "LOFT: Archive Sessions"
3. Select your project directory, then let LOFT detect the session files automatically
4. Choose the options you want and click "Archive Sessions"

What Gets Archived

Your session files are archived with automatic cleanup:

Files Included:

• ✅ All JSONL session files
• ✅ Complete conversation history
• ✅ All metadata and context

Cleanup (Always Applied):

• 🧹 System API errors
• 🧹 Token/authentication failures
• 🧹 Network/service errors (4xx, 5xx)
• 🧹 Agent subagent remote model failures
• 🧹 Synthetic error messages

All valid session data is preserved!

When ZIP creation is enabled, the cleaned folder is deleted after the archive is written, leaving only the ZIP file.

API Compatibility

• VS Code: ^1.0.0
• Node.js: 22.x (or later)
• TypeScript: 5.9.3

📋 Requirements

• VS Code 1.0.0 or later

❓ FAQ

Q: Will this delete my original sessions?
A: No! The extension leaves your originals untouched. If ZIP mode is enabled, only the cleaned archive artifact is removed after the ZIP is written.

Q: Can I undo the cleaning?
A: Yes! Your original session files remain untouched.

Q: What's the difference between "filtered" and "pass-through" JSONL files?
A: Filtered files had errors removed; pass-through files had no errors and were copied as-is.

Q: Is my data processed locally?
A: Yes! All processing happens on your machine. No data is sent anywhere.

Get Started: Open VS Code and run the "LOFT: Archive Sessions" command!

Release Notes

1.0.0

• Initial release with interactive session archiving and cleanup
• Project-directory detection with automatic session discovery
• ZIP archive generation for Aquila submission