✨ What it does

• 🧹 Clean my Mac — scans user caches, logs, Xcode DerivedData, simulator caches, npm/pnpm/Homebrew caches and Trash. Shows sizes, lets you pick, and only ever deletes the contents of well-known junk folders — never your documents.
• 🧠 Free up RAM — lists your biggest memory consumers, highlights forgotten dev processes (python servers, node, docker…) and the ports they listen on, and stops the ones you select (graceful SIGTERM first, SIGKILL if they resist).
• ⚡ Optimize performance — purge inactive RAM, flush DNS, restart Dock/Finder, Homebrew cleanup, empty Trash, reset QuickLook previews.
• 🤖 AI assistant — chat with a local Ollama model that sees a live snapshot of your RAM, disk and processes. If Ollama is missing it downloads and installs it for you; if it's not running it starts it.
• 🛡️ Permission modes — choose Ask (the app double-checks before risky actions) or Full (power-user, no extra prompts). Your choice is saved.
• ⬆️ Self-updating — checks npm on launch and offers a one-key update.

Everything runs 100% locally. Nothing leaves your Mac. The only network calls are npm update checks and Ollama install/model downloads.

Install

npm install -g @vindepemarte/thecleaner-pro

Requires macOS and Node.js ≥ 18.

Use

thecleaner-pro              # launch the TUI
thecleaner-pro update       # update to the latest version
thecleaner-pro uninstall    # remove it from your Mac
thecleaner-pro --help

Inside the TUI: ↑↓ navigate · enter select · space toggle · esc back · q quit.

🛡️ Permission modes

theCleaner-pro never hard-limits what you can do — it just lets you decide how careful it should be. Pick a mode from Settings; it's saved to ~/.config/thecleaner-pro/config.json.

| Mode | What it does | Best for | | --- | --- | --- | | Ask (default) | Confirms before cleaning, killing processes, or running an optimization | Everyone — the safe default | | Full | Skips the app's own confirmations and runs your selected actions right away | Power users who know what they want |

macOS still asks for your password on admin actions (purge RAM, flush DNS) in both modes — that prompt comes from the system, not the app.

Requirements

• macOS (built & tested on Apple Silicon)
• Node.js ≥ 18
• Ollama for the AI assistant — installed automatically if missing

Contributing

Issues and PRs are welcome at github.com/vindepemarte/thecleaner-pro. It's a small, hackable Node.js + Ink codebase.

☕ Support the journey

theCleaner-pro is free and open source. If it earned a spot in your toolkit and you'd like to support the journey, you can buy me a coffee — every cup keeps the broom sweeping. 🧹

License

MIT © vindepemarte