{"slug": "tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode", "title": "🦥 TidySloth CLI: The Local-First File Organizer That Embraces Sloth Mode", "summary": "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.", "body_md": "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)\n\nTidySloth CLI is a lightweight, privacy-focused, local-first Python command-line utility designed to automate digital file organization.\n\nInstead 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.\n\nHere is tidysloth-cli in action inside VS Code:\n\nKey Features:\n\nscan mode: Previews file distribution and updates the index without moving anything.\n\ntidy mode: Safely organizes files into categorized subfolders.\n\n--dry-run flag: Lets you preview exact move operations risk-free.\n\nTIDY_INDEX.md Generation: Keeps a clean Markdown manifest of all organized files.\n\nA local-first Python file-organizer CLI that cleans up digital clutter at sloth speed. Built with **GitHub Copilot**.\n\n`Code`, `Documents`, `Images`, `Archives`, and `Others`\n`pathlib` for safe path handling and `argparse` for CLI parsing`--dry-run`\n`TIDY_INDEX.md`) for both scan and tidy runs\nRun from this repository root:\n\n```\npython tidysloth.py --help\n```\n\nScans files and writes `TIDY_INDEX.md` with category counts and file listings.\n\n```\npython tidysloth.py scan --path ./target_folder\n```\n\nIf no target is provided, the current directory is used:\n\n```\npython tidysloth.py scan\n```\n\nMoves files into category subfolders and updates `TIDY_INDEX.md`.\n\n```\npython tidysloth.py tidy --path ./target_folder\n```\n\nPreview all move operations without changing any files:\n\n```\npython tidysloth.py tidy --path ./target_folder --dry-run\n```\n\nTidySloth was engineered from the ground up using GitHub Copilot as an AI pair programmer.\n\nBuilt using Python standard libraries (pathlib for safe cross-platform file system operations and argparse for subcommands), GitHub Copilot assisted across the entire build workflow:\n\nCLI Architecture: Copilot scaffolded clean subcommand parsing (scan and tidy).\n\nSafe File Operations: Assisted in implementing dry-run previews, collision prevention, and directory creation logic.\n\nMarkdown Generation: Automated the string formatting logic for generating the TIDY_INDEX.md report.\n\nDigital file clutter often contains sensitive information—personal documents, private code snippets, financial records, or configuration files.\n\n100% Private & Offline: TidySloth processes everything locally. Your private filenames and directory contents are never transmitted to cloud servers or third-party APIs.\n\nZero Cost & Latency: Runs instantly with zero cloud dependencies, API keys, or subscriptions.\n\nReliable Local Execution: It works anywhere—on a flight, off the grid, or on low-power devices.\n\nSorting 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.\n\nBest Use of GitHub Copilot (Built using GitHub Copilot for code architecture, CLI parsing, and Markdown generation).", "url": "https://wpnews.pro/news/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode", "canonical_source": "https://dev.to/riyadhami13/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode-3cga", "published_at": "2026-10-22 06:07:08+00:00", "updated_at": "2026-10-22 06:10:39.099582+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools"], "entities": ["TidySloth CLI", "GitHub Copilot", "Python", "Hacktoberfest", "VS Code"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode", "markdown": "https://wpnews.pro/news/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode.md", "text": "https://wpnews.pro/news/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode.txt", "jsonld": "https://wpnews.pro/news/tidysloth-cli-the-local-first-file-organizer-that-embraces-sloth-mode.jsonld"}}