macOS · Go + Cocoa
Get Started →
Open Source · Zero Sudo · Apple Silicon Ready

Clean Your Mac.
Own Your Desk.

A fast, safety-first macOS CLI, 6-tab terminal command center, and native top-right Desk HUD. Reclaim gigabytes with reversible quarantine, inspect real RAM & GPU pressure, and stay in flow with built-in focus timers and tasks.

go install github.com/Anigunda/macclean@latest
Try Interactive Demo → GitHub Repo
6
Interactive TUI Tabs
2S
Live Desk HUD Refresh
7D
Quarantine Undo Window
0
Sudo Prompts Needed
Six Tabs · One Binary

Built Beyond A Cleaner

01
Safe Junk Cleaner

Deep user-level scan with zero sudo prompts and smart Keep rules that protect important data.

  • Cleans ~/Library/Caches, Logs, Trash & $TMPDIR
  • Targets Xcode DerivedData, npm, Gradle & Maven
  • Detects stale node_modules & uninstalled app leftovers
  • Protects ollama, huggingface & custom rules
Tab 1 · Clean YAML Rules
02
Quarantine & Undo

Every risky delete can be quarantined first so you can inspect and restore files anytime.

  • Moves items safely into ~/.macclean/quarantine
  • Restores full batches without overwriting existing paths
  • Journals every run in history.jsonl with freed totals
  • Auto-purges expired batches after configurable days
Tab 2 · History 1-Click Restore
03
Real System Telemetry

Accurate macOS Activity-Monitor metrics instead of misleading raw physical RAM numbers.

  • Separates real memory used from reclaimable file cache
  • Reads live Apple Silicon GPU % & VRAM via IOAccelerator
  • Tracks CPU user/sys split, load average & free disk GB
  • Lists top CPU-consuming processes sorted live
Tab 3 · System vm_stat + GPU
04
Local Mac Doctor

Plain-English diagnostics explaining why your laptop feels slow, hot, or won't sleep.

  • Checks disk headroom against reclaimable junk size
  • Flags high memory pressure & swap thrashing (vm.swapusage)
  • Highlights CPU spikes and top process culprits
  • Detects battery level & apps blocking sleep (pmset)
Tab 4 · Doctor 100% Local
05
Focus, Tasks & Tidy

Built-in daily productivity workflows that go beyond system cleaning.

  • 25m / 50m Pomodoro focus timer with macOS notifications
  • caffeinate Keep Awake toggle for long builds or calls
  • Desktop & Downloads size radar + 1-click file organizer
  • Markdown tasks (~/.macclean/tasks.md) with ★ pinning
Tab 5 · Focus Zero Clutter
06
Desk HUD & LaunchAgents

A native Cocoa floating widget synced two-ways with your terminal UI and macOS login.

  • Small top-right HUD visible across all macOS Spaces
  • Live CPU, GPU & MEM bars + running processes + tasks
  • Collapses to a compact pill (Hide/Show) or unpins cleanly
  • Manages login auto-start & weekly Mon 09:00 schedules
Tab 6 · Settings Cocoa HUD
Interactive Demo

Watch It Work. Try It Live.

HyperFrames 44s Walkthrough Self-explanatory tour: Clean · Undo · System · Doctor · Focus · Tasks · Desk HUD
1080p · 30fps
Live Sandbox

Two Surfaces. Always In Sync.

macclean Mac Command & Clean Center
Focus 24:10 · CPU 14% · GPU 11% · MEM 56% · 182G free
macclean • Apple M4 (10C)
CPU 14.2% (usr 6.1% · sys 8.1%)
GPU 11.0% (rend 11% · 512M)
MEM 56.4% (13.5G/24G · 7.6G cache)
TOP PROCESSES
412 WindowServer 18.4% 0.9%
1316 Terminal 11.2% 0.6%
1220 Google Chrome 6.8% 1.9%
1157 gopls 4.1% 1.4%
TASKS (3) · CLICK TO COMPLETE
718 procs · Focus 24:10 · Awake · 182G free
Architecture

Safety By Design

100%
Local & Private
1
Self-Contained Binary
YAML
Human Config File
MD
Plain-Text Tasks

How It Protects You

01
Never touches OS directories. Phase-1 targets are strictly user-level caches, logs, temp folders, and developer build caches.
02
Smart Keep Rules built in. Protects ollama, huggingface, active apps, and your custom substrings in config.yaml.
03
Reversible Quarantine + Tidy. Quarantined items & old installers stay recoverable from the History tab without overwriting existing files.

What Lives On Your Mac

01
Config: ~/.config/macclean/config.yaml stores keep/delete rules, retention days, auto-start, and pin state.
02
Tasks & Archive: Active tasks in ~/.macclean/tasks.md; completed tasks archived to tasks-done.md.
03
LaunchAgents: Optional com.macclean.autostart & com.macclean.weekly toggled directly in Settings.
CLI Reference

Every Command Ready

maccleanLaunch the 6-tab interactive TUI
macclean deskOpen the top-right floating Desk HUD
macclean focusJump straight to Focus, Tasks & Tidy
macclean settingsConfigure auto-start, pin, rules & schedule
macclean scan --detailInspect cleanable items from your shell
macclean clean --quarantineSafe clean with rollback batch created
macclean undoList or restore quarantined batches
macclean schedule onEnable weekly Monday 09:00 auto-clean
Build From Source · macOS

Keep It Clean.
Stay In Flow.

Clone from GitHub, run go install ., and pin macclean to your desk in under 30 seconds.

View On GitHub →