🦥 TidySloth CLI: The Local-First File Organizer That Embraces Sloth Mode

Description and use

TidySloth CLI automatically sorts files in a local folder, creating categories and a Markdown report, while processing data entirely offline.

Problem

Users spend excessive time manually sorting files in Downloads, Desktop, or project folders, leading to clutter and inefficiency.

Outcome

TidySloth completes a typical downloads‑folder cleanup in less than 1 second, generating a structured Markdown index and preserving privacy by operating entirely offline.

Workflow

• Run "python tidysloth.py scan --path ./target_folder" to preview distribution and generate TIDY_INDEX.md.
• Run "python tidysloth.py tidy --path ./target_folder" to move files into category subfolders.
• Optionally add "--dry-run" to preview move operations without changing files.

Evidence

TidySloth scans your target directory, categorizes clutter into clean subfolders (Code, Documents, Images, Archives, and Others), and generates a clear Markdown summary index (TIDY_INDEX.md).

Source

Sorting a cluttered downloads directory manually usually takes 10–15 minutes of tedious drag-and-drop effort. TidySloth completes the same job in less than 1 second.

Source

100% Private & Offline: TidySloth processes everything locally. Your private filenames and directory contents are never transmitted to cloud servers or third-party APIs.

Source