Metadata-Version: 2.4
Name: jhadoo
Version: 1.2.8
Summary: Smart cleanup tool for developers - removes unused venv, node_modules, Docker images, scans Git repos, and more
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 — one command to reclaim disk space

[![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** finds every stale environment across your entire machine and reclaims the space in seconds — so you can keep vibe coding without ever worrying about storage.

```bash
pipx install jhadoo && jhadoo --dry-run
```

## Why jhadoo?

Vibe coding with Cursor, Copilot, Bolt, Windsurf, or any AI tool is incredibly productive — but it leaves behind a trail of heavyweight folders that pile up fast:

| Folder | Typical size | Created by |
|---|---|---|
| `venv` / `.venv` | 200 MB – 2 GB | Every Python project |
| `node_modules` | 300 MB – 1 GB+ | Every JS/TS project |
| `__pycache__` | 1 – 50 MB | Python runtime |
| `build` / `dist` | varies | Every build cycle |

A few weeks of vibe coding can silently consume **20–50 GB**. jhadoo scans your entire home directory, identifies projects you haven't touched in a while, and cleans up their heavy folders — automatically, safely, and in parallel.

## Features

- **Universal** — cleans venv, node_modules, build, dist, target, caches, or any custom folder name
- **Smart staleness detection** — only cleans folders whose parent project is genuinely inactive (ignores OS metadata like .DS_Store, Thumbs.db, etc. that create false freshness)
- **Safe** — dry‑run, size caps, confirmations, archive with one‑click restore
- **Fast** — single-pass parallel scan; prunes heavy dirs (.git, .cache, Library, $RECYCLE.BIN, etc.)
- **Scheduled** — built‑in cron / Task Scheduler support
- **Git Analysis** — detect stale branches & large files (`--git-check`)
- **Docker Cleanup** — prune unused images (`--docker`)
- **Dashboard** — track your savings over time (`--dashboard`)
- **Cross‑platform** — macOS, Windows, Linux
- **Private** — anonymous opt‑out‑anytime telemetry; no IPs, paths, or file names collected

## Usage

```bash
jhadoo                # clean now
jhadoo --dry-run      # safe preview
jhadoo --archive      # move instead of delete
jhadoo --restore      # undo last archive
jhadoo --dashboard    # view savings & trends
```

See [`examples/`](examples/) for config, scheduling, Python API, and more.

## Install

```bash
# Recommended
pipx install jhadoo

# Or
pip install jhadoo
```

## Privacy & Telemetry

Anonymous telemetry tracks global space savings (random ID, bytes saved, OS, version — nothing else).
- Disable: `jhadoo --telemetry-off`
- Status: `jhadoo --telemetry-status`

## License

MIT — see [LICENSE](LICENSE)

---

If this saved you GBs, please ⭐️ the repo.
