🧹 CompresoClean

A free, no-subscription macOS cleaner for professionals.
Built by Viswanath Bodasakurthi · OneMark Agency

Replaces CleanMyMac — no paywalls, no accounts, no bloat.

---

✨ What It Does

CompresoClean is a lightweight macOS cleaning app that frees up disk space in seconds. It was built for the OneMark team and is now open-sourced for anyone who's tired of paying for software that does something a well-written shell script can do better.

Feature	Details
🗑️ Caches & Logs	Clears system caches, app logs, and temp files
📦 npm & Homebrew	Prunes package manager leftovers
🗂️ Trash	Empties system Trash
🎨 Creative Apps	Cleans Photoshop, After Effects, Premiere Pro, DaVinci Resolve, Final Cut Pro
🔍 Dynamic Detection	Uses Spotlight (mdfind) — finds apps even outside /Applications
📋 Run Logs	Every cleanup logged to ~/.compresoclean.log with timestamps
🔔 Notifications	macOS notification shows MB freed after each run
✅ Confirmation Dialog	Asks before cleaning — no accidental wipes

---

🚀 Installation

Option 1 — Download DMG (Recommended)

1. Go to Releases and download CompresoClean_v1.1.dmg
2. Open the DMG and drag CompresoClean.app to /Applications
3. Double-click to run

First run: macOS may show a security warning. Go to System Settings → Privacy & Security and click Open Anyway.

Option 2 — Build from Source

git clone https://github.com/viswanathbodasakurthi/CompresoClean.git
cd CompresoClean
chmod +x build.sh
./build.sh

This assembles the .app bundle and outputs a DMG to ~/Desktop/CompresoClean_v1.1.dmg.

---

🛠️ Editing the Script

The cleaner logic lives in a single shell script:

src/CompresoClean

To modify and rebuild:

# 1. Edit the script
nano src/CompresoClean

# 2. Rebuild the app + DMG
./build.sh

Or, to edit directly inside the installed app using Claude Code:

cd /Applications/CompresoClean.app/Contents/MacOS
claude

---

📁 Repo Structure

CompresoClean/
├── app/
│   └── CompresoClean.app/       ← Full .app bundle (plug-and-play)
├── src/
│   └── CompresoClean            ← Standalone shell script (source of truth)
├── build.sh                     ← Assembles .app + DMG from src/
├── docs/
│   ├── instructions.md          ← Usage guide
│   └── CHANGELOG.md             ← Version history
├── .gitignore
└── README.md

---

📋 Run Log

Every cleanup is appended to:

~/.compresoclean.log

Example entry:

[2025-06-10 14:32:01] CompresoClean v1.1 — Cleanup complete. 3,421 MB freed.

---

📦 Releases

Version	Date	Notes
v1.1	2025-06	Dynamic app detection, macOS notifications, run logging
v1.0	2025-05	Initial release

Full changelog → docs/CHANGELOG.md

---

🤝 Built With

• Shell Script — the entire cleaner is a single bash script
• Claude Code — used for iterative development inside the terminal
• hdiutil — native macOS DMG creation
• mdfind / Spotlight — dynamic app path detection

---

🏢 About OneMark

OneMark is a design and engineering agency building tools, platforms, and digital products.
This tool was built internally and open-sourced because good software should be free.

---

📄 License

MIT License — use it, fork it, ship it.
Attribution appreciated but not required.

---

Made with 🖤 by Viswanath Bodasakurthi · OneMark Agency