Thread Archive Feature
Archive old threads to searchable archives and restore them with automatic session capture.
Features
- Archive threads: Compress completed threads to
archive/{YYYY}-{name}.tar.gzwith a searchable.mdsummary containing dates and keywords - Restore with history: Brings archived threads back to
threads/and automatically writes asessions/{YYYYMMDD}-restored.mdcapturing 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 inspectto 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 |