jhadoo 1.3.0

Smart multi-platform cleanup tool for a seamless vibe coding experience - auto-cleans unused files, caches, apps, installers, and project build bloat

✨ jhadoo — Auto-clean unused files for a seamless vibe coding experience

Every AI-assisted coding session spins up a fresh venv, node_modules, or build cache. Multiply that by dozens of projects and your disk is quietly eaten alive.

jhadoo automatically scans, finds, and cleans up every stale environment, installer, app remnant, and cache directory across your entire machine — keeping your disk fresh and light so you can maintain a seamless, fast, and continuous vibe coding experience without ever worrying about storage.

pipx install jhadoo && jhadoo --dry-run

---

🎯 Features at a Glance

• ⚡ Stunning Terminal TUI (jhadoo --tui) — A fully interactive, 24-bit Truecolor terminal dashboard featuring:
  • Hierarchical Disk Explorer (DaisyDisk-inspired): Browse nested directory sizes, expand folders, mark elements, and run secure cleanups via arrow keys or Vim bindings (h/j/k/l).
  • Live Hardware Telemetry (iStat Menus-inspired): Real-time graphical tracking of logical CPU core loads, memory usage dials, I/O rates, and your dynamic System Health Score.
• 🌿 Multi-Platform System Optimizer (jhadoo --optimize) — Flush system DNS caches, wipe heavy temporary paths, clean package stores (apt, dnf, brew), and safely refresh standard workspace desktops across macOS, Windows, and Linux.
• 📦 Application Uninstaller (jhadoo --uninstall [APP]) — Scans and removes application bundles along with deep-nested properties, plist caches, launch daemons, and application support footprints securely.
• 🚚 Setup Installer Sweeper (jhadoo --installers) — Crawler that finds duplicate or bulky installer files (.dmg/.pkg on Mac, .msi/.exe setups on Windows, .deb/.rpm packages on Linux).
• 🔍 Smart Staleness Detection — Evaluates genuine developer project activity. Skip folders modified by standard system metadata (like .DS_Store or Thumbs.db) that create false freshness signals.
• 🛡️ Ironclad Protection & Zero-Risk Safety Guardrails:
  • Protected System Blacklist: Hard-touch restrictions completely barring modifications inside OS directories (e.g. /System, C:\Windows, /boot).
  • Dry Run Default (--dry-run / -n): Preview exactly what folders, caches, or settings will be cleaned before committing.
  • Archive and Restore (--archive / --restore): Safely backups uninstalled programs or installer sweeps to a local archive (~/.jhadoo_archive) so you can instantly rollback via one command.

---

🚀 Why jhadoo?

Vibe coding with Cursor, Copilot, Bolt, Windsurf, or Replit is incredibly productive — but it leaves a massive footprint of heavy dependencies that pile up extremely fast:

Folder	Typical Size	Created By	Status
venv / .venv	200 MB – 2 GB	Every Python project	Auto-cleanable
node_modules	300 MB – 1 GB+	Every JS/TS project	Auto-cleanable
__pycache__	1 – 50 MB	Python runtime execution	Auto-cleanable
build / dist / target	Varies (100MB – 4GB)	C / Rust / Go / Java build pipelines	Auto-cleanable

A few weeks of continuous AI vibe coding can silently eat up 20–50 GB of storage. Jhadoo runs in a single-pass, multi-threaded parallel sweep to keep your workspaces clean automatically.

---

🔧 Installation & Setup

# Recommended (isolated global binary)
pipx install jhadoo

# Or standard pip
pip install jhadoo

Note: For Windows users wishing to run the interactive dashboard, ensure you install windows-curses via: pip install windows-curses.

---

💡 Usage Guides

1. Launch the Interactive TUI Dashboard

jhadoo --tui   # Or simply: jhadoo -t

• Use standard Arrow Keys or Vim Hotkeys (h/j/k/l) to navigate folders.
• Press Enter to drill-down, Backspace to move up, Space to mark for cleanup, and d to execute!

2. Run System Optimizations

jhadoo --optimize   # Flush DNS, temporary folders, package caches, and reload workspace

3. Sweep Heavy Installers

jhadoo --installers  # Scan Downloads and Desktop for setups (.dmg, .pkg, .msi, etc.)

4. Deep App Uninstallation

jhadoo --uninstall spotify  # Safely locate and clean Spotify config, launch agents, and cache files

5. Safe Command Line Cleanups (Automated)

jhadoo                # Run default development project sweep
jhadoo --dry-run      # Secure preview (recommended first run)
jhadoo --archive      # Archive to local store (~/.jhadoo_archive) instead of deleting
jhadoo --restore      # Restore previous archived session files back to original spots
jhadoo --dashboard    # View logging, trends, and total accumulated storage savings

---

🔒 Safety, Privacy & Telemetry

1. System Guardians: If any matched path falls inside operating system targets, Jhadoo immediately aborts and logs a warning.
2. Private by Design: Jhadoo collects no IP addresses, usernames, folders, or file names.
3. Minimalist Telemetry: Anonymous telemetry simply tracks global bytes saved, runtime duration, and OS types to map Jhadoo's overall open-source impact.
   • Disable: jhadoo --telemetry-off
   • Check status: jhadoo --telemetry-status

---

📄 License

MIT — see LICENSE

---

If Jhadoo kept your system snappy and saved you gigabytes of storage, please consider giving us a ⭐️ on GitHub!