{"id":29640400,"url":"https://github.com/aaurelions/clearrr","last_synced_at":"2026-04-11T03:31:10.781Z","repository":{"id":304251441,"uuid":"1018241721","full_name":"aaurelions/clearrr","owner":"aaurelions","description":"🧹 Effortlessly clear heavy temp folders — safely, fast, and with full control.","archived":false,"fork":false,"pushed_at":"2025-10-03T20:34:45.000Z","size":3474,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-03T22:25:34.824Z","etag":null,"topics":["cache-cleaner","cache-control","cleaner","cleaning-data","clear","cleardata","delete","node","nodejs","php","python","rust"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/clearrr","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaurelions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-11T21:29:39.000Z","updated_at":"2025-10-03T20:33:17.000Z","dependencies_parsed_at":"2025-07-11T23:34:35.908Z","dependency_job_id":"02ff2418-5c6a-4f26-a8de-bd6ca687b7a1","html_url":"https://github.com/aaurelions/clearrr","commit_stats":null,"previous_names":["aaurelions/clearrr"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/aaurelions/clearrr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaurelions%2Fclearrr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaurelions%2Fclearrr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaurelions%2Fclearrr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaurelions%2Fclearrr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaurelions","download_url":"https://codeload.github.com/aaurelions/clearrr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaurelions%2Fclearrr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31668046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cache-cleaner","cache-control","cleaner","cleaning-data","clear","cleardata","delete","node","nodejs","php","python","rust"],"created_at":"2025-07-21T21:02:03.735Z","updated_at":"2026-04-11T03:31:10.758Z","avatar_url":"https://github.com/aaurelions.png","language":"JavaScript","readme":"# clearrr\n\n\u003cimg src=\"https://raw.githubusercontent.com/aaurelions/clearrr/refs/heads/main/banner.png\"\u003e\n\n**🧹 Effortlessly clear project junk, system caches, and find large files — safely, fast, and with full control.**\n\n---\n\n## ✨ What is clearrr?\n\n`clearrr` is a simple but powerful CLI tool to **find and remove large, temporary folders and files**.\n\nIt has three main functions:\n\n1.  **Clean Projects:** Remove build artifacts and dependency folders like `node_modules`, `.venv`, `dist`, `build`, and `target` to free up gigabytes across all your projects.\n2.  **Clean System Caches:** The `cache` command safely removes gigabytes of disposable cache files from your user home directory, targeting tools like Xcode, npm, pip, Docker, browsers, and more.\n3.  **Find Large Files \u0026 Folders:** The `large` command scans any directory and shows you a top-10 list of the largest files or folders, helping you pinpoint what's taking up your disk space.\n\nIt’s safe by design:\n\n- **Dry-run by default:** Nothing is deleted unless you confirm.\n- **Powerful presets** for projects and system caches.\n- Runs anywhere instantly with `npx`.\n\n---\n\n## ⚡️ Quick Start\n\n#### 1. To clean a project directory:\n\n\u003cimg src=\"https://raw.githubusercontent.com/aaurelions/clearrr/refs/heads/main/screenshot.png\"\u003e\n\n```bash\n# See what would be deleted in the current folder\nnpx clearrr\n\n# Actually delete the files\nnpx clearrr --confirm\n```\n\n#### 2. To clean your system's user caches:\n\n\u003cimg src=\"https://raw.githubusercontent.com/aaurelions/clearrr/refs/heads/main/screenshot2.png\"\u003e\n\n```bash\n# See how much space you can reclaim from global caches\nnpx clearrr cache\n\n# Perform the cleanup\nnpx clearrr cache --confirm\n```\n\n#### 3. To find what's taking up space:\n\n```bash\n# Find the 10 largest files in the current directory\nnpx clearrr large files 10\n\n# Find the 15 largest folders in your home directory\nnpx clearrr large folders 15 ~/\n```\n\n---\n\n## ✅ Features\n\n- 🏠 **System Cache Cleaning** — A dedicated `cache` command to clear gigabytes from your user home directory.\n- 📊 **Disk Usage Analysis** — Find the largest files or folders in any directory to see what's using your space.\n- 🗂️ **Recursive Project Scanning** — Finds temp folders deep within any path.\n- 🔒 **Dry-run by Default** — See what will be deleted \u0026 how much space you’ll free.\n- ⚙️ **Smart Presets** — Targets for Node, Python, PHP, and Rust projects.\n- ⚡️ **Fast** — Powered by `fast-glob` and includes a progress spinner for long operations.\n- 🧩 **Custom Patterns** — Override presets with your own list.\n- 🧹 **Safe** — Never touches `.git`, source files, or config folders.\n\n---\n\n## 📦 Install (optional)\n\nYou can run with `npx` — **no install needed**.\n\nOr install globally for daily use:\n\n```bash\nnpm install -g clearrr\n```\n\n---\n\n## 🏁 Usage\n\n### 1. Cleaning Project Folders\n\nThis is the default command. It scans a directory for build artifacts and dependencies.\n\n**Dry-run example (default)**\nCheck what would be deleted for Node projects in a specific monorepo:\n\n```bash\nnpx clearrr ./my-monorepo --preset=node\n```\n\n**Actually delete (must confirm)**\nDelete safely by adding the `--confirm` flag:\n\n```bash\nnpx clearrr ./my-monorepo --preset=node --confirm\n```\n\n### 2. Cleaning Global System Caches\n\nThe `cache` command scans your user home directory (`~/`) for common application and development tool caches that are safe to delete.\n\n**Dry-run the cache cleaner:**\n\n```bash\nnpx clearrr cache\n```\n\n**Confirm to free up gigabytes of space:**\n\n```bash\nnpx clearrr cache --confirm\n```\n\n### 3. Finding Large Files \u0026 Folders\n\nThe `large` command is a disk analysis tool that helps you find what's taking up the most space. It does not delete anything.\n\n**Syntax:** `npx clearrr large \u003ctype\u003e [dir] [count]`\n\n- `\u003ctype\u003e`: Must be either `files` or `folders`.\n- `[dir]`: Optional directory to scan (default: current directory).\n- `[count]`: Optional number of items to show (default: 10).\n\n**Example: Find the 10 largest files**\nScan the current folder and its subfolders for the largest files.\n\n```bash\nnpx clearrr large files\n```\n\n**Example: Find the 5 largest folders in `~/Library`**\nThis can help you identify bloated application support or cache folders.\n\n```bash\nnpx clearrr large folders ~/Library 5\n```\n\n---\n\n## 📁 Presets (for cleaning)\n\n| Preset            | Folders Targeted                                                                                                      |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------- |\n| `node`            | `node_modules`, `.next`, `.nuxt`, `.turbo`, `.parcel-cache`, `.cache`, `dist`, `build`                                |\n| `python`          | `venv`, `.venv`, `__pycache__`, `.mypy_cache`, `.pytest_cache`, `build`, `dist`, `.tox`                               |\n| `php`             | `vendor`                                                                                                              |\n| `rust`            | `target`                                                                                                              |\n| `all` _(default)_ | Everything in `node` + `python` + `php` + `rust`.                                                                     |\n| **`cache`**       | `~/.cache`, `~/Library/Caches`, `Xcode DerivedData`, `npm`, `pip`, `Docker`, `Yarn`, `browser caches`, and many more. |\n\n---\n\n## 🧯 Safety\n\n- ✅ **Dry-run by default** for cleaning commands — nothing is deleted unless `--confirm` is set.\n- ✅ The `large` command is read-only and never deletes files.\n- ✅ Targets only well-known disposable directories.\n- ✅ Does not touch `.git`, `.vscode`, `.idea`, or any source folders.\n- ✅ Reports total disk space to be freed up before asking for confirmation.\n\n---\n\n## 🛠️ Options (for cleaning)\n\n| Option             | Description                               | Default       |\n| ------------------ | ----------------------------------------- | ------------- |\n| `[dir]`            | Root folder to scan (project mode only)   | `.` (current) |\n| `--preset`         | `node`, `python`, `php`, `rust`, or `all` | `all`         |\n| `--patterns`       | Override preset with custom comma-list    | —             |\n| `--dry-run`        | Explicit dry-run                          | `true`        |\n| `--confirm`        | Actually delete matched folders           | `false`       |\n| `--[no-]recursive` | Enable/disable recursive search           | `true`        |\n\n---\n\n## 📊 Example output\n\n**Cleaning Command:**\n\n```bash\n🧹 clearrr preset: node\n📂 Searching in: /Users/you/Developer\n🧩 Patterns: node_modules,.next,.nuxt,.turbo,.parcel-cache,.cache,dist,build\n\n[dry-run] Would delete: /Users/you/Developer/project1/node_modules (242.3 MB)\n[dry-run] Would delete: /Users/you/Developer/project2/.next (58.1 MB)\n\n✅ Would free approximately 300.4 MB.\n\n💡 To confirm deletion, re-run with --confirm\n```\n\n**Large Files Command:**\n\n```bash\n🔎 Finding the 10 largest folders in /Users/you\nThis may take a few moments...\n✔ Scan complete. Filtering for the most specific paths...\n\nTop 10 largest files:\n17.0 GB    /Users/you/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw\n2.3 GB     /Users/you/Library/Application Support/BraveSoftware/Brave-Browser/Default/Favicons\n1.7 GB     /Users/you/Library/Application Support/tts/tts_models--.../model.pth\n...\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaurelions%2Fclearrr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaurelions%2Fclearrr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaurelions%2Fclearrr/lists"}