SpecStory Organize

Organizes your .specstory/history directory by moving session files into YYYY/MM/ subdirectories based on the timestamp in each filename.

How It Works

1. Scans .specstory/history/ for markdown files
2. Extracts the date from filenames (e.g., 2026-01-22_19-20-56Z-fix-bug.md)
3. Creates year/month folders (e.g., 2026/01/)
4. Moves files into the appropriate subdirectory
5. Reports what was moved

Why Organize?

Over time, your history directory can accumulate hundreds of session files. Organizing by date makes it easier to:

• Find sessions from a specific time period
• Archive old sessions
• Keep your project directory clean