| name | organize-screenshots |
| description | Move screenshots into YYYY-MM dated folders so the desktop/screenshots folder stops drowning (use when screenshots are piling up) |
| version | 1.0.0 |
| author | 0pen-sourcer |
| tools | ["list_directory","create_directory","move_path"] |
Organize screenshots
Tuck loose screenshots into month folders by their date, so the folder stays readable. Non-destructive: moves only, never deletes or overwrites.
Steps
- Ask where the screenshots live if unknown — common spots:
~/Pictures/Screenshots, the Desktop, or ~/Pictures.
list_directory there. Identify screenshots by name pattern (Screenshot*, Screen Shot*, image*.png) and/or image extensions (png, jpg, jpeg).- For each screenshot, determine its month:
- Prefer the date embedded in the filename (e.g.
Screenshot 2026-06-17 ... → 2026-06).
- If the name has no date, fall back to the file's modified time.
create_directory <folder>/<YYYY-MM> as needed.move_path each screenshot into its month folder. On a name clash, append (2), (3), … — never overwrite.- Report how many moved into each month folder.
Don't
- Don't move non-screenshot images the user clearly curated (skip anything already inside a named subfolder).
- Don't delete or rename beyond the clash-suffix.
- If you're unsure whether a file is a screenshot, leave it and mention it.
