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

A developer built TidySloth CLI, a local-first Python command-line tool that scans a target directory, sorts files into Code, Documents, Images, Archives and Others subfolders, and generates a Markdown manifest (TIDY_INDEX.md). The utility offers scan and tidy subcommands plus a --dry-run flag for previewing moves, and was developed with GitHub Copilot as an AI pair programmer. The developer says the tool runs fully offline with no cloud dependencies, API keys or subscriptions, completing in under a second what manual sorting takes 10–15 minutes.

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 3: Slow and Steady https://dev.to/challenges/hacktoberfest-week3-2026-10-19 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 subfolders Code, Documents, Images, Archives, and Others , and generates a clear Markdown summary index TIDY INDEX.md . It channels your inner sloth by handling the tedious file cleanup you keep putting off—all in milliseconds on your own machine. Here is tidysloth-cli in action inside VS Code: Key Features: scan mode: Previews file distribution and updates the index without moving anything. tidy mode: Safely organizes files into categorized subfolders. --dry-run flag: Lets you preview exact move operations risk-free. TIDY INDEX.md Generation: Keeps a clean Markdown manifest of all organized files. A local-first Python file-organizer CLI that cleans up digital clutter at sloth speed. Built with GitHub Copilot . Code , Documents , Images , Archives , and Others pathlib for safe path handling and argparse for CLI parsing --dry-run TIDY INDEX.md for both scan and tidy runs Run from this repository root: python tidysloth.py --help Scans files and writes TIDY INDEX.md with category counts and file listings. python tidysloth.py scan --path ./target folder If no target is provided, the current directory is used: python tidysloth.py scan Moves files into category subfolders and updates TIDY INDEX.md . python tidysloth.py tidy --path ./target folder Preview all move operations without changing any files: python tidysloth.py tidy --path ./target folder --dry-run TidySloth was engineered from the ground up using GitHub Copilot as an AI pair programmer. Built using Python standard libraries pathlib for safe cross-platform file system operations and argparse for subcommands , GitHub Copilot assisted across the entire build workflow: CLI Architecture: Copilot scaffolded clean subcommand parsing scan and tidy . Safe File Operations: Assisted in implementing dry-run previews, collision prevention, and directory creation logic. Markdown Generation: Automated the string formatting logic for generating the TIDY INDEX.md report. Digital file clutter often contains sensitive information—personal documents, private code snippets, financial records, or configuration files. 100% Private & Offline: TidySloth processes everything locally. Your private filenames and directory contents are never transmitted to cloud servers or third-party APIs. Zero Cost & Latency: Runs instantly with zero cloud dependencies, API keys, or subscriptions. Reliable Local Execution: It works anywhere—on a flight, off the grid, or on low-power devices. 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. I used it this week to clean up my messy project workspace and instantly generate structured Markdown indexes without breaking my focus. Best Use of GitHub Copilot Built using GitHub Copilot for code architecture, CLI parsing, and Markdown generation .