Skip to content

Thread Archive Feature

Choose a tag to compare

@sebmartin sebmartin released this 23 May 23:20
· 39 commits to main since this release
3602e5a

Archive old threads to searchable archives and restore them with automatic session capture.

Features

  • Archive threads: Compress completed threads to archive/{YYYY}-{name}.tar.gz with a searchable .md summary containing dates and keywords
  • Restore with history: Brings archived threads back to threads/ and automatically writes a sessions/{YYYYMMDD}-restored.md capturing the archive-time summary as thread history
  • Archive fallback: Resume command automatically checks archives if an active thread isn't found
  • Inspect without restoring: Peek into an archive with /threads inspect to review before restoring
  • Security: Rejects symlinks during archive (prevents leaking out-of-thread paths), validates extraction paths, requires Python 3.12+

Breaking Changes

  • Requires Python 3.12+ (for tarfile.extractall(filter="data") support)
  • Dropped zip archive fallback; always uses tar.gz

Commands

Command Purpose
/ai-workspace:threads archive <name> Archive a completed thread
/ai-workspace:threads restore <base> Restore an archived thread
/ai-workspace:threads list-archived Show all archived threads with keywords
/ai-workspace:threads inspect <base> Extract an archive to archive/tmp/ for inspection
/ai-workspace:threads purge-tmp Clean up temporary archive extractions