🦥 TidySloth CLI: The Local-First File Organizer That Embraces Sloth Mode
This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady What I Built TidySloth CLI is a lightweight, privacy-focused, local-first Python command-line utility designed to automate digital file organization. Instead of spending precious time sorting messy Downloads, Desktop, or project folders, TidySloth scans your target directory, categorizes clutter into clean…
TidySloth CLI is a lightweight, privacy-focused, local-first Python command-line utility designed to automate digital file organization. This tool scans target directories, sorts clutter into subfolders like Code, Documents, Images, Archives, and Others, and creates a Markdown summary index (TIDY_INDEX.md). TidySloth channels the user's inner sloth by handling tedious file cleanup at lightning speed, all on the user's own machine.
Key features include a scan mode that previews file distribution and updates the index without moving any files, a tidy mode that safely organizes files into categorized subfolders, and a --dry-run flag that lets users preview exact move operations risk-free. TidySloth also generates a clean Markdown manifest of all organized files.
Developed by RiyaDhami13, TidySloth is built with GitHub Copilot as an AI pair programmer. Using standard Python libraries (pathlib for safe cross-platform file system operations and argparse for CLI parsing), Copilot assisted in subcommand parsing, safe file operations, and Markdown generation. The tool works entirely offline, ensuring 100% privacy as all data is processed locally, with no transmission to cloud servers or third-party APIs.
TidySloth completes the same job in less than one second compared to manually sorting a cluttered downloads directory, which typically takes 10-15 minutes.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
