Is it safe?
Yes. Cleanup moves files to the Trash, where you can put them back, unless you choose Delete Immediately. Empty Trash deletes what's already in the Trash, even items Finder can't, like folders whose path is too long, and both ask first. Safe to clear only holds things that rebuild themselves, like caches and build folders. Anything an app or a Claude Code session still has open is left alone, and Disk Forecast says which one. It can quit them for you and try again, after naming each one. System Data fixes, like removing local Time Machine snapshots, run Apple's own tools after you confirm.
Will it warn me before my disk is full?
Yes. When the forecast says your disk will be full within a week, or space runs low, you get a notification naming what grew most that week and how much emptying the Trash would get back. At most once a day, and you can turn it off in Settings.
How accurate is the forecast?
It's a trend, not a promise, which is why it says “~”. It follows the typical day-to-day change in free space over the last two weeks, so one big download or cleanup doesn't throw it off. It appears after 3 days of history and says how fast space is changing: “Full in ~41 days · using 3.5 GB a day”, “Steady”, or “Free space growing”. When space is low, it says so whatever the trend.
Why does it want Full Disk Access?
It doesn't need it. Everything works with your home folder. Full Disk Access lets it measure the folders macOS guards, like Mail, Messages, iCloud Drive, and other apps' containers. Without it, their space shows up as unexplained.
What is System Data?
The catch-all bar in Storage settings for everything macOS doesn't file under a named category: local Time Machine snapshots, purgeable space, simulator runtimes, caches, Apple Intelligence models, the Spotlight index. The guide walks through each one.
Does it slow down my Mac or drain the battery?
It's built not to. Between scans it reads free space once an hour, a single question to macOS. Scans run about twice a day at background priority, on the efficiency cores with throttled disk reads, and one that falls due on battery waits for the charger unless the last scan is more than a day and a half old. Choose Rescan in the menu whenever you want a fresh count at full speed.
Which Macs does it run on, and how do I install it?
Any Mac on macOS 14 Sonoma or later, Apple silicon or Intel. Download the DMG from GitHub and drag Disk Forecast to Applications, or run brew install --cask coreyhaines31/tap/diskforecast, which also puts the diskforecast command on your PATH. It has no Dock icon: look for the tape reel in the menu bar.
Why not the App Store?
App Store apps run in a sandbox that can't see most of your disk, so a disk tool there can't measure System Data or run Apple's fixes. Disk Forecast is signed and notarized by Apple, and installs from GitHub or Homebrew.
How do I update or uninstall it?
It checks for updates on its own, and Check for Updates… in the menu checks now. With Homebrew, brew upgrade --cask diskforecast works too. To uninstall, run brew uninstall --cask --zap diskforecast, or move Disk Forecast from Applications to the Trash and remove ~/Library/Application Support/Disk Forecast, where its history lives.
Can my AI agent use it?
Yes. Disk Forecast comes with a diskforecast command, so Claude Code, Codex, or any agent that runs commands can check the forecast, see which folders grew, and list what's safe to clear. It can only move things on the cleanup list, only to the Trash, and shows what it would move until it's told --yes. Homebrew puts the command on your PATH. Every command.
Does it clean up after coding agents?
Yes. It finds the git worktrees Claude Code, Codex, and other agents leave behind and lists each under Worth a look with what removing it would lose: changed files and commits no remote has. Removing one also clears git's records of it, like git worktree remove. Under Safe to clear, it lists what agents download to work: npx packages like MCP servers, older browsers for Playwright and agent-browser, older Claude Code versions, and the temp files Claude Code leaves in /private/tmp after a session, which can reach tens of gigabytes. More on git worktrees.
Is it really free?
Yes, at home or at work. No account, no trial, no subscription. The source is on GitHub, so you can read exactly how it counts and what it moves to the Trash.