Metadata-Version: 2.4
Name: jhadoo
Version: 1.3.0
Summary: Smart multi-platform cleanup tool for a seamless vibe coding experience - auto-cleans unused files, caches, apps, installers, and project build bloat
Home-page: https://github.com/bhav09/jhadoo
Author: Bhavishya
Author-email: your.email@example.com
Project-URL: Bug Tracker, https://github.com/bhav09/jhadoo/issues
Project-URL: Documentation, https://github.com/bhav09/jhadoo#readme
Project-URL: Source Code, https://github.com/bhav09/jhadoo
Keywords: cleanup,disk-space,file-management,folder-cleanup,development-tools,build-cleanup,cache-cleanup,automation,devops,universal-cleaner,multi-language,folder-agnostic
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: notifications
Requires-Dist: win10toast>=0.9; platform_system == "Windows" and extra == "notifications"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: flake8>=6.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-python
Dynamic: summary

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

[![PyPI version](https://badge.fury.io/py/jhadoo.svg)](https://badge.fury.io/py/jhadoo) [![Total Downloads](https://static.pepy.tech/badge/jhadoo?style=flat&units=international_system)](https://pepy.tech/projects/jhadoo) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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.

```bash
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

```bash
# 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
```bash
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
```bash
jhadoo --optimize   # Flush DNS, temporary folders, package caches, and reload workspace
```

### 3. Sweep Heavy Installers
```bash
jhadoo --installers  # Scan Downloads and Desktop for setups (.dmg, .pkg, .msi, etc.)
```

### 4. Deep App Uninstallation
```bash
jhadoo --uninstall spotify  # Safely locate and clean Spotify config, launch agents, and cache files
```

### 5. Safe Command Line Cleanups (Automated)
```bash
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](LICENSE)

---

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