Sloth Sorter

Описание и применение

Sloth Sorter автоматически сортирует файлы в папке, используя локальную модель LLM, и переименовывает их, чтобы облегчить ручную работу.

Задача

Users manually drag and rename files in cluttered folders like Downloads.

Результат

Files are organized into folders like Images, Receipts, and Documents with clean names, reducing manual effort.

Рабочий процесс

• Point Sloth Sorter at a folder
• Script reads each file’s name, size, and short preview
• Local Ollama model returns JSON with category and kebab‑case name
• Script validates category, sanitizes name, plans move
• Dry run outputs plan and requires --apply to execute
• User reviews plan and approves with a flag
• Script moves files, logs actions to .sloth-undo.json
• Optional --undo restores original state

Доказательства

Sloth Sorter is a lazy file tidier. Point it at a messy folder and it reads each file, decides where it belongs, gives it a clean descriptive name, and files it away.

Источник

It saves the chore everyone puts off: dragging Screenshot (47).png, invoice_final_v2.pdf and download(3).zip into folders and renaming them.

Источник

Example of the dry-run output: Screenshot 2026-10-12 at 9.41.03.png -> Images/dashboard-error-message.png invoice_final_v2.pdf -> Receipts/invoice-final-v2.pdf notes.txt -> Documents/meeting-notes-q4-planning.txt Dry run: 3 files. Re-run with --apply to do it.

Источник

It never overwrites files; name collisions get a numeric suffix.

Источник

If the model is unreachable, it falls back to sorting by file extension.

Источник