jasonwong1991 / WonderBox
git clone https://github.com/jasonwong1991/WonderBox.git
v0.6.0 · 9d ago
A native macOS system toolkit: honest memory optimization, deep cleanup that finds the real space hogs, fan control, keep-awake, disk analyzer.
—
stars, 24h
—
stars, 7 days
+430
stars, 30 days · #633
430
★ total
20
forks · 0 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguageSwift
LicenseMIT
Created2026-09-20 (1mo ago)
Last push6d ago
Watchers1
OwnerUser
GitHub topics
Links
README excerpt
WonderBox A native macOS system toolkit that tells you the truth about your Mac. Memory that actually shrinks, cleanup that finds the real space hogs, and numbers you can verify in Activity Monitor. English · 简体中文 > The interface supports English and Simplified Chinese. Scans and diagnostic logs stay on-device. Update checks contact GitHub; logs are shared only if you export and send them yourself. ## Why WonderBox Most "Mac cleaners" show you a big green number and hope you don't check. WonderBox is built the other way around: - **Memory optimization that works on compressed memory.** `purge` only drops file cache, so tools that rely on it leave the "Compressed" figure untouched. WonderBox's root helper issues the same kernel memory-pressure broadcast macOS uses, so every running app trims its caches — and the compressed pages behind them are freed too. Then it reports the before/after per category and names the apps that responded. - **Per-app memory you can act on.** Helper processes are rolled up into their host app (Chrome's 40 renderers show as one line), with an estimate of how much of each app is sitting in the compressor or swap. Quit or force-quit from the same row. - **Cleanup that finds the tens of gigabytes, not the megabytes.** Package-manager caches, Chromium/Electron web caches, sandboxed container caches, simulator and DeviceSupport files — the places that actually fill a developer's disk. - **Honest numbers.** Lower bounds are shown as `≥` when a size estimate times out. Results say what changed, or say plainly that nothing did. - **Safety by construction.** Every deletion is checked against a per-category whitelist of roots and path shapes. User data (chat databases, documents, Docker VMs, toolchains) is never a candidate. Anything that isn't a rebuildable cache goes to the Trash. ## Features ### Memory - Activity Monitor's categories — App, Wired, Compressed, Cached Files, Available — plus swap usage and the kernel's pressure level - Per-app physical footprint ranking with the compressed/swapped share of each app, and graceful or force quit - One-click optimization: system-wide memory-pressure broadcast, then file-cache purge, with a per-category before/after report - The overview health banner reflects memory pressure, not just thermal state ### CPU and GPU - Full-width usage charts show a rolling 60-second window with time/percentage axes. Missing GPU readings and sampling gaps are not drawn as idle time. - Live per-application rankings, including helper processes, refreshed every 3 seconds; search, quit and force quit from the list - CPU follows Activity Monitor's convention: one occupied core is 100%, so multi-core apps can exceed 100% - GPU process usage comes from driver-provided context counters where available; unsupported drivers show `—`, not a fabricated zero. Concurrent contexts can total more than the overall device utilization - Uptime includes sleep, matching System Information's “Time since boot” ### Spac