Stop Paying for Mac Cleaners: Why I Built Upkeep
A free, open-source health coach for your macOS system that replaces "snake oil" optimizers.
We’ve been conditioned to think of our computers as black boxes that gradually accumulate a mysterious, heavy grime. We buy “optimizing” apps that promise to “deep clean” our systems, often without ever explaining what they are actually deleting. It’s digital superstition... a ritual of clicking a glowing button to make a progress bar move.
Last month, I decided to stop guessing. I wanted a tool that didn’t just “clean” but curated. I wanted to know exactly which log files were stale, which Time Machine snapshots were bloating my drive, and why my Spotlight index was suddenly acting like it had amnesia.
The result is Upkeep. It’s an open-source macOS maintenance toolkit designed for Tahoe, Sequoia, and Sonoma. No TUI (for now), no mystery, and most importantly... no snake oil.
The Problem with “Magic” Buttons
Most commercial maintenance tools are built on obfuscation. They hide the actual system commands they are running because if you saw how simple the fix was, you wouldn’t pay the $40 annual subscription.
Even worse... many of these apps are destructive by default. They flush caches that macOS actually needs to stay fast. They “optimize” RAM by forcing the system to dump useful data into slower swap space. They treat your OS like a patient in need of an exorcism rather than an athlete in need of a coach.
Upkeep is different. It is built on three hypothesis-driven pillars:
Visibility: You see the data before you run the command.
Safety: Age-based trimming ensures we only remove what is truly stale.
Transparency: Every operation explains the why and the impact.
The Maintenance Lab: 19 Targeted Operations
Instead of a single “Clean” button, Upkeep provides 19 specific maintenance operations. Each one is a targeted intervention.
Smart Storage Analysis
Most tools just tell you that “System Data” is taking up 150GB. Upkeep’s storage analyzer is more surgical. It categorizes your files by type and, more importantly, by age. It identifies the high-impact targets... large videos, forgotten Docker layers, and heavy downloads... and visualizes them so you can decide what stays.
Age-Based Trimming
We don’t just “clear logs.” We trim them. Upkeep targets logs and caches that are older than 30 days. This preserves the “warm” data your system is actively using to stay fast while shedding the historical weight that serves no purpose.
The “Deep” Kit
Sometimes things actually are broken. Upkeep includes a “Deep” maintenance tier for those moments:
Time Machine Snapshot Thinning: When local snapshots haven’t been purged correctly, Upkeep uses
tmutilto reclaim that space safely.Spotlight Rebuilding: If search is failing, it forces a clean reindex of the boot volume.
DNS Cache Flushing: For the “Sequoia/Tahoe” networking quirks that sometimes require a fresh start.
Set It and Forget It: The Scheduling Engine
The biggest gap I found in existing tools was the friction of remembering to run them. Real maintenance isn’t a one-time event; it’s a rhythm.
Upkeep includes a built-in Scheduling Engine powered by macOS’s native launchd system. You can set it to run a “Safe All” check every Sunday at 3 AM. It’s a “set and forget” architecture that ensures your Mac stays healthy while you sleep.
Because it uses launchd, it is incredibly light on resources. It doesn’t need to be “running” in your menu bar, eating up RAM. It only wakes up when it has work to do, runs its checks, logs the results to ~/Library/Logs/upkeep/, and goes back to sleep.
Why Open Source?
I’m making Upkeep available for free on GitHub because our tools shouldn’t be a secret. I want you to read the code. I want you to see exactly how we verify disk integrity and check your SMART status.
There are over 245 automated tests ensuring that this tool is safe, reliable, and respectful of your data. It’s built on a foundation of 1,350 lines of careful Bash, a FastAPI web backend, and a TypeScript frontend.
Final Thoughts
A healthy Mac isn’t one that has been “cleaned” of its history. It’s one that has been curated.
Use Upkeep to understand your machine better. Use it to automate the boring parts of maintenance. But most of all, use it to reclaim your agency from the subscription-based “optimizer” industry.
Your Mac is a tool. Keep it sharp.
Resources & Further Reading
Foundational Concepts
A Brief History of macOS Memory Management — Howard Oakley (The Eclectic Light Company) Why it’s relevant: This provides the technical evidence for why “RAM Cleaners” are often a myth; Oakley explains how macOS uses “Cached Files” to speed up your system and why forcing them to clear is counterproductive.
The periodic(8) Man Page — SS64 Reference Why it’s relevant: Upkeep automates what Apple already provides. This guide explains the daily, weekly, and monthly scripts (periodic) that have been part of macOS’s BSD heritage for decades.
Daemons and Services: launchd Guide — Apple Developer Documentation Why it’s relevant: This is the official documentation for the scheduling engine Upkeep uses. It explains why
launchdis more efficient than “background apps” for system maintenance.
Practical Guides
macOS Security and Privacy Guide — drduh (GitHub) Why it’s relevant: A community-standard “Lab Notebook” for power users. It provides a deep dive into the security settings (SIP, FileVault, Gatekeeper) that Upkeep audits in its health check.
Deep Dives
How to Rebuild the Spotlight Index — Apple Support Why it’s relevant: Provides the manual context for one of Upkeep’s “Deep Kit” operations, explaining when and why a search index might need to be forced into a reset.
OnyX Maintenance Utility — Titanium Software Why it’s relevant: The classic, respected alternative to “snake oil” apps. Viewing OnyX helps readers understand the lineage of transparent, free maintenance tools that Upkeep aims to modernize.
The macOS System Architecture Overview — Apple Developer Documentation Why it’s relevant: For the reader who wants to understand the “black box” the article mentions. This covers the Darwin kernel and the core OS layers that Upkeep interacts with via Bash.
Recommended Book
Take Control of Maintaining Your Mac — Joe Kissell Why it’s relevant: The definitive “athlete’s coach” handbook for Mac users. Kissell aligns with the Upkeep philosophy of avoiding “cleanup” apps and focusing on smart, intentional system health.