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.

来源