{"id":35214545,"url":"https://github.com/mohit-bagri/cachekaro","last_synced_at":"2026-01-20T17:35:34.496Z","repository":{"id":330548996,"uuid":"1123111336","full_name":"Mohit-Bagri/cachekaro","owner":"Mohit-Bagri","description":"🧹 Cross-platform storage \u0026 cache cleaner for macOS, Linux \u0026 Windows. Analyze  disk usage, find cache hogs and free up space. Clean It Up!","archived":false,"fork":false,"pushed_at":"2025-12-26T15:31:50.000Z","size":478,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-27T20:05:31.972Z","etag":null,"topics":["cache-cleaner","cleanup","cli","disk-space","linux","macos","pyhton","storage-analyzer","system-utility","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mohit-Bagri.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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-12-26T07:50:05.000Z","updated_at":"2025-12-26T16:52:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"0105e1d0-2efe-4c1b-b0b5-c80ee9b12fe3","html_url":"https://github.com/Mohit-Bagri/cachekaro","commit_stats":null,"previous_names":["mohit-bagri/cachekaro"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Mohit-Bagri/cachekaro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mohit-Bagri%2Fcachekaro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mohit-Bagri%2Fcachekaro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mohit-Bagri%2Fcachekaro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mohit-Bagri%2Fcachekaro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mohit-Bagri","download_url":"https://codeload.github.com/Mohit-Bagri/cachekaro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mohit-Bagri%2Fcachekaro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28165067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-01T02:00:06.694Z","response_time":59,"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","cleanup","cli","disk-space","linux","macos","pyhton","storage-analyzer","system-utility","windows"],"created_at":"2025-12-29T21:20:40.847Z","updated_at":"2026-01-01T23:03:37.980Z","avatar_url":"https://github.com/Mohit-Bagri.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# **CacheKaro**\n\n### Cross-Platform Storage \u0026 Cache Manager\n\n**CacheKaro** - *Clean It Up!*\n\n[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg)](#-platform-support)\n[![Tests](https://img.shields.io/badge/tests-53%20passing-brightgreen.svg)](#-development)\n\n⭐ **If you find CacheKaro useful, please consider giving it a star!** ⭐\n\n[Overview](#-overview) · [Installation](#-installation) · [Uninstall](#-uninstall) · [Quick Start](#-quick-start) · [Commands](#-commands) · [Detection](#-what-it-detects) · [Safety](#-safety--risk-levels) · [Export Formats](#-export-formats) · [Config](#-configuration) · [Development](#-development) · [Platform Support](#-platform-support) · [License](#-license)\n\n\u003c/div\u003e\n\n---\n\n## ▸ Overview\n\n**CacheKaro** is a cross-platform CLI tool to analyze and clean cache/storage on **macOS**, **Linux** and **Windows**. It automatically discovers caches from all installed applications and games.\n\n### Why CacheKaro?\n\n| # | Feature | Description |\n|:-:|---------|-------------|\n| 1 | **Auto-Discovery** | Automatically detects 300+ known apps and any new software you install |\n| 2 | **Cross-Platform** | One tool for macOS, Linux and Windows |\n| 3 | **Developer Friendly** | Cleans npm, pip, Gradle, Maven, Cargo, Go, Docker and more |\n| 4 | **Game Support** | Steam, Epic Games, Riot Games, Battle.net, Minecraft and more |\n| 5 | **Creative Suite** | Adobe CC, DaVinci Resolve, Blender, Ableton, AutoCAD and more |\n| 6 | **Safe by Default** | Risk-based classification prevents accidental data loss |\n| 7 | **Beautiful Reports** | Cyberpunk-themed HTML reports with charts |\n\n---\n\n## ▸ Installation\n\n### • Prerequisites\n\n- Python 3.9 or higher\n- pip (Python package manager)\n\n### • Install via pip (Recommended)\n\n```bash\npip install cachekaro\n```\n\n### • Install from Source\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/Mohit-Bagri/cachekaro.git\n\n# 2. Navigate to the ROOT folder (not cachekaro/cachekaro)\ncd cachekaro\n\n# 3. Create and activate virtual environment (recommended)\npython3 -m venv venv\nsource venv/bin/activate        # macOS/Linux\n# OR\n.\\venv\\Scripts\\activate         # Windows\n\n# 4. Install CacheKaro\npip install -e .\n```\n\n### • Verify Installation\n\n```bash\ncachekaro --version\n```\n\n\u003e **Note:** If installed from source, the `cachekaro` command only works when the virtual environment is activated. Always run `source venv/bin/activate` before using CacheKaro.\n\n### • 🚀 Getting Started (Run These After Install!)\n\n```bash\n# See what's taking up space\ncachekaro analyze\n\n# View system info\ncachekaro info\n\n# Generate a detailed HTML report\ncachekaro report\n\n# Clean caches safely (interactive)\ncachekaro clean\n\n# Get help\ncachekaro --help\n```\n\n---\n\n## ▸ Uninstall\n\n```bash\npip uninstall cachekaro\n```\n\nTo also remove configuration files:\n\n| Platform | Command |\n|----------|---------|\n| macOS/Linux | `rm -rf ~/.config/cachekaro` |\n| Windows | `rmdir /s %APPDATA%\\cachekaro` |\n\n---\n\n## ▸ Quick Start\n\n```bash\n# ► Analyze your storage\ncachekaro analyze\n\n# ► Preview what can be cleaned (safe mode)\ncachekaro clean --dry-run\n\n# ► Clean caches interactively\ncachekaro clean\n\n# ► Auto-clean all safe items without prompts\ncachekaro clean --auto\n\n# ► Generate cyberpunk HTML report\ncachekaro report --output report.html\n```\n\n---\n\n## ▸ Commands\n\n### • `cachekaro analyze`\n\nScans and displays all cache/storage usage on your system.\n\n```bash\ncachekaro analyze                          # Basic analysis\ncachekaro analyze -f json                  # Output as JSON\ncachekaro analyze -f csv -o data.csv       # Export to CSV\ncachekaro analyze -c browser               # Only browser caches\ncachekaro analyze --min-size 100MB         # Only items \u003e 100MB\ncachekaro analyze --stale-days 7           # Mark items older than 7 days as stale\n```\n\n| Option | Short | Description | Default |\n|--------|-------|-------------|---------|\n| `--format` | `-f` | Output format: `text`, `json`, `csv` | `text` |\n| `--output` | `-o` | Save output to file | stdout |\n| `--category` | `-c` | Filter: `browser`, `development`, `game`, `application`, `system` | all |\n| `--min-size` | — | Minimum size filter (e.g., `50MB`, `1GB`) | `0` |\n| `--stale-days` | — | Days threshold for stale detection | `30` |\n\n---\n\n### • `cachekaro clean`\n\nRemoves cache files based on selected criteria.\n\n```bash\ncachekaro clean                            # Interactive mode\ncachekaro clean --dry-run                  # Preview only, no deletion\ncachekaro clean --auto                     # Auto-clean without prompts\ncachekaro clean --auto --risk moderate     # Include moderate risk items\ncachekaro clean -c browser                 # Clean only browser caches\ncachekaro clean --stale-only               # Clean only stale items\n```\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--dry-run` | Preview what would be deleted without actually deleting | `false` |\n| `--auto` | Automatically clean all items without confirmation prompts | `false` |\n| `--category` | Category to clean: `browser`, `development`, `game`, `application`, `system` | all |\n| `--risk` | Maximum risk level: `safe`, `moderate`, `caution` | `safe` |\n| `--stale-only` | Only clean items older than stale threshold | `false` |\n\n---\n\n### • `cachekaro report`\n\nGenerates detailed visual reports with charts.\n\n```bash\ncachekaro report                           # Generate HTML report\ncachekaro report -o myreport.html          # Custom filename\ncachekaro report -f json -o report.json    # JSON format\n```\n\n| Option | Short | Description | Default |\n|--------|-------|-------------|---------|\n| `--format` | `-f` | Report format: `html`, `json`, `csv`, `text` | `html` |\n| `--output` | `-o` | Output file path | `cachekaro_report_\u003ctimestamp\u003e.html` |\n\n---\n\n### • `cachekaro info`\n\nDisplays system information and CacheKaro configuration.\n\n```bash\ncachekaro info\n```\n\n---\n\n### • `cachekaro update`\n\nCheck for updates and get upgrade instructions.\n\n```bash\ncachekaro update                           # Check for new versions\n```\n\nCacheKaro automatically notifies you when a new version is available each time you run a command.\n\n---\n\n## ▸ What It Detects\n\n### • Automatic Discovery\n\nCacheKaro automatically scans standard cache directories and identifies **any** application by its folder name. It recognizes 300+ known apps with friendly names.\n\n### • Categories\n\n| # | Category | Examples |\n|:-:|----------|----------|\n| 1 | **Browser** | Chrome, Firefox, Safari, Edge, Brave, Arc, Vivaldi, Opera |\n| 2 | **Development** | npm, pip, Cargo, Gradle, Maven, Docker, VS Code, JetBrains, Xcode |\n| 3 | **Games** | Steam, Epic Games, Riot Games, Battle.net, Minecraft, Unity, GOG |\n| 4 | **Creative** | Photoshop, Premiere Pro, After Effects, DaVinci Resolve, Final Cut Pro |\n| 5 | **3D \u0026 Design** | Blender, Cinema 4D, Maya, ZBrush, SketchUp, Figma, Sketch |\n| 6 | **Audio** | Ableton Live, FL Studio, Logic Pro, Pro Tools, Cubase, GarageBand |\n| 7 | **Engineering** | AutoCAD, SolidWorks, Fusion 360, MATLAB, Simulink, Revit |\n| 8 | **Applications** | Spotify, Discord, Slack, Zoom, WhatsApp, Notion, Obsidian |\n| 9 | **System** | OS caches, temp files, logs, crash reports, font caches |\n\n### • Platform-Specific Paths\n\n| Platform | Locations Scanned |\n|----------|-------------------|\n| **macOS** | `~/Library/Caches`, `~/.cache`, `~/Library/Logs`, `~/Library/Application Support` |\n| **Linux** | `~/.cache`, `~/.config`, `~/.local/share`, `~/.steam`, `~/.var/app` |\n| **Windows** | `%LOCALAPPDATA%`, `%APPDATA%`, `%TEMP%`, `%USERPROFILE%` |\n\n---\n\n## ▸ Safety \u0026 Risk Levels\n\n| Level | Icon | Description | Examples |\n|-------|------|-------------|----------|\n| **Safe** | 🟢 | 100% safe to delete, no data loss | Browser cache, npm cache, pip cache, temp files |\n| **Moderate** | 🟡 | Generally safe, may require re-login or re-download | HuggingFace models, Maven repo, Docker images |\n| **Caution** | 🔴 | Review before deleting, may contain user data | Downloads folder, application data |\n\n```bash\n# ► Only clean safe items (default behavior)\ncachekaro clean --risk safe\n\n# ► Include moderate risk items\ncachekaro clean --risk moderate\n\n# ► Preview caution-level items before cleaning\ncachekaro clean --risk caution --dry-run\n```\n\n---\n\n## ▸ Export Formats\n\n| # | Format | Use Case | Command Example |\n|:-:|--------|----------|-----------------|\n| 1 | **Text** | Terminal output with colors | `cachekaro analyze` |\n| 2 | **JSON** | APIs and automation | `cachekaro analyze -f json` |\n| 3 | **CSV** | Spreadsheet analysis | `cachekaro analyze -f csv -o data.csv` |\n| 4 | **HTML** | Interactive reports with charts | `cachekaro report` |\n\n---\n\n## ▸ Configuration\n\n### • Config File Location\n\n| Platform | Path |\n|----------|------|\n| macOS/Linux | `~/.config/cachekaro/config.yaml` |\n| Windows | `%APPDATA%\\cachekaro\\config.yaml` |\n\n### • Example Config\n\n```yaml\nsettings:\n  stale_threshold_days: 30      # Days before item is considered stale\n  default_format: text          # Default output format\n  color_output: true            # Enable colored terminal output\n  backup_before_delete: false   # Create backup before deletion\n\ncustom_paths:                   # Add your own cache paths\n  - path: ~/my-app/cache\n    name: My App Cache\n    category: custom\n    risk_level: safe\n```\n\n---\n\n## ▸ Development\n\n```bash\n# ► Setup development environment\ngit clone https://github.com/Mohit-Bagri/cachekaro.git\ncd cachekaro\npython3 -m venv venv\nsource venv/bin/activate\npip install -e \".[dev]\"\n\n# ► Run tests\npytest\n\n# ► Linting \u0026 type checking\nruff check .\nmypy cachekaro\n```\n\n---\n\n## ▸ Platform Support\n\n| OS | Python 3.9 | Python 3.10 | Python 3.11 | Python 3.12 |\n|----|:----------:|:-----------:|:-----------:|:-----------:|\n| macOS | ✓ | ✓ | ✓ | ✓ |\n| Ubuntu | ✓ | ✓ | ✓ | ✓ |\n| Windows | ✓ | ✓ | ✓ | ✓ |\n\n---\n\n## ▸ License\n\nMIT License — see [LICENSE](LICENSE)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade in 🇮🇳 with ❤️ by [MOHIT BAGRI](https://github.com/Mohit-Bagri)\n\n**CacheKaro** - *Clean It Up!*\n\n⭐ **Star this repo if you found it helpful!** ⭐\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohit-bagri%2Fcachekaro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohit-bagri%2Fcachekaro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohit-bagri%2Fcachekaro/lists"}