Free, with the source on GitHub

Know before your Mac runs out of space.

A free menu bar app that tells you when your Mac's disk will be full, weeks ahead, then shows you what's safe to clear.

0 stars on GitHub

macOS 14 or later · Apple Silicon and Intel · brew install --cask coreyhaines31/tap/diskforecast

Or install it with Claude Code or Codex

Paste this into a coding agent that can run commands on your Mac.

Install Disk Forecast, a free macOS menu bar app (https://github.com/coreyhaines31/diskforecast), on this Mac:

1. Check that macOS is 14 or later with `sw_vers -productVersion`. If it's older, stop and tell me.
2. If Homebrew is installed (`command -v brew`), run:
   brew install --cask coreyhaines31/tap/diskforecast
   Otherwise, install the latest release from GitHub:
   url=$(curl -fsSL https://api.github.com/repos/coreyhaines31/diskforecast/releases/latest | grep -o 'https://[^"]*\.dmg' | head -1)
   curl -fsSL -o /tmp/DiskForecast.dmg "$url"
   mnt=$(mktemp -d) && hdiutil attach -nobrowse -quiet /tmp/DiskForecast.dmg -mountpoint "$mnt"
   cp -R "$mnt/Disk Forecast.app" /Applications/ && hdiutil detach -quiet "$mnt" && rm /tmp/DiskForecast.dmg
3. Check it's notarized: `spctl --assess --type exec -v "/Applications/Disk Forecast.app"` should say "Notarized Developer ID".
4. Open it: `open -a "Disk Forecast"`.
5. Open the Full Disk Access settings for me:
   open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"
   Then tell me to turn on Disk Forecast there (it's optional), that its tape reel icon with my free space is now in the menu bar, and that from now on I can ask you why my disk is filling up or what's safe to clear. You'll use the `diskforecast` command (see `diskforecast --help`; if it isn't on the PATH, it's at "/Applications/Disk Forecast.app/Contents/MacOS/diskforecast").

Don't change any other settings and don't delete anything.

4:40 PM. The export stops at 92%.

An hour into the render, a dialog says there isn't enough disk space. Last week you had 40 GB free. Now you're dragging things to the Trash from folders you've never opened, hoping none of them matter, while the deadline gets closer.

Disk Forecast sees that coming. Six days earlier, it would have sent you this.

It says when the disk fills, what's driving it, and the quickest space to get back. Click it and Cleanup opens.

Why is my Mac storage full?

It's usually three questions at once, and Storage settings leaves all three open.

“Where did 40 GB go?”

Storage settings shows what's on the disk today, not what changed. Disk Forecast saves folder sizes after every scan, so it can name the folder that grew and say since when.

“Why is System Data so big?”

Apple's own help says you can't manage what's in it. Disk Forecast names the parts, like local Time Machine snapshots, simulator runtimes, the Spotlight index, and Docker, and fixes each with its owner's own tool.

“What can I delete safely?”

Every item on the cleanup list says what it is and what happens when it goes. Things that rebuild themselves come checked. Everything else waits for you, and it all goes to the Trash first.

Three steps, then it watches for you.

One optional permission and nothing to configure. After that it works from the menu bar on its own.

  1. Open it once

    It lives in the menu bar as a tape reel with your free space beside it. Show the percent free or just the icon instead, if you like. The reel fills with your disk: roomy under 40% used, filling up to 80%, nearly full past that. No Dock icon, and it starts at login.

  2. Give it three days

    Free space is read every hour and saved once a day. On day three the forecast appears. Meanwhile it measures your home folder, then again about twice a day at background priority. On battery, a scan that falls due waits for the charger, unless the last one is more than a day and a half old.

  3. Hear about it early

    When the forecast says full within a week, or free space drops under 10% or 20 GB, you get a notification, at most one a day. It names what grew and opens Cleanup when you click it. Turn it off in Settings if you'd rather check the menu yourself.

WhenWhat you'll see
Right awayFree space, the folders taking the most space, and how much is Safe to clear
Day 2The chart in the menu draws its first line
Day 3The forecast: “Full in ~41 days”, “Steady”, or “Free space growing”
After scans on two different daysWhat changed in the Forecast window, and “Grew most this week” in the menu

A weather report for your disk.

Every hour it checks your free space. After 3 days it knows your typical pace, and tells you when you'll hit zero if it keeps up. A week out, you get a notification that names what's been growing.

The forecast is the median day-to-day change in free space over the last 14 days, so one 50 GB download or one big cleanup doesn't swing it. Open Forecast… from the menu for the full chart, with 2 weeks, 30 days, or 4 months of history and a dashed line to a red Full marker. Under it are three numbers: your typical day, the lowest point in the range, and the date it's full by.

Forecast ready in 2 days

Still learning. It needs readings from three days in the last two weeks.

Full in ~41 days · using 5.1 GB a day

Filling. Rounded the way people say it: days for the next two months, then months, then “over 2 years”.

Steady · about the same free space each day

Changing by less than 100 MB on a typical day. That's noise, not a trend.

Low on space: 6% free

Shown whatever the trend once you're under 10% or 20 GB free, and the menu bar reel shows nearly full.

Which folder grew this week?

Storage settings shows a snapshot. Disk Forecast keeps the history. After each scan it saves the size of every folder in your home folder over 100 MB, three levels deep, and keeps 120 days of them on your Mac.

The Forecast window compares today with the start of the range you pick and lists every folder that changed by more than 500 MB, biggest first. Open one to see which of its folders did it. New folders are marked New. Space that changed outside your home folder, like System Data, other accounts, and apps, gets its own line.

The menu shows the week's biggest mover once it's at least 1 GB, so you don't have to open anything to see it.

What's taking up space on my Mac?

Open the menu and the five biggest folders are right there, named at a useful depth. When a folder is mostly one subfolder, the way ~/Library is mostly ~/Library/Developer on a developer's Mac, the menu shows the subfolder instead, up to four levels down. The list names what's actually big.

Each one opens a submenu with what Cleanup knows inside it, biggest first. Pick one and Cleanup opens at that item. Show in Finder takes you to the folder itself.

When Cleanup doesn't know a folder, it says so. Suggest a Rule opens a GitHub issue filled in with the folder's location and size, asking what makes it and whether it comes back. Nothing is sent until you submit it, and you can edit it first.

New in 1.10, the storage meter under the forecast splits used space into Apps, Developer, Photos, Movies, Documents, Music, Caches, Trash, and System and other, each counted once. Pick the Peak meter, rows of lit dots, or the VU meter, a tape for each category, in Settings › General. Hover a category to see its share. With Full Disk Access on, Empty Trash sits right below it.

What usually takes up space, folder by folder

System Data, explained.

Storage settings tells you how big System Data is and stops there. Disk Forecast names each part, says what it is, and fixes it with Apple's own tools when you ask.

Read the System Data guide

Every fix opens a confirmation that shows the exact command before anything runs, and if one doesn't finish, you see what it said. Here's what each one does.

In System DataWhat the fix runs
Local Time Machine snapshotstmutil deletelocalsnapshots, once per snapshot. Your backups on the backup disk aren't touched.
Spotlight indexmdutil -E /, after macOS asks for your password. Search results are incomplete while it rebuilds.
Simulatorsxcrun simctl delete unavailable for simulators whose runtime is gone, or xcrun simctl runtime delete for one runtime. Xcode downloads it again when you need it.
Dockerdocker system prune -f. Running containers, volumes, and tagged images stay. Start Docker first so it can be measured.
Apple Intelligence and Siri modelsNothing runs. It opens System Settings, where turning Apple Intelligence off removes its models.
Purgeable spaceNothing to run. It's already counted as free, and macOS hands it back when an app needs room.

Reclaim space you can spare.

Caches, logs, and build folders from old projects rebuild themselves, so they come checked. Everything else waits for you, like git worktrees your coding agents left behind, old Claude Code and Codex conversations, and Screen Studio projects you've already exported. Each worktree shows what removing it would lose. It all goes to the Trash unless you choose to delete it now. Anything an app or a Claude Code session still has open stays put, with an offer to quit it and try again.

Every cleanup rule, in plain English.

29 rules, each explained in the app the way it is here. Anything under 1 MB isn't listed, and downloads under 10 MB aren't either. An “old” project is one you haven't changed in 30 days; set anything from 7 to 365 days in Settings › Scanning.

Safe to clear · checked

Rebuilds itself

  • Build folders in old projectsnode_modules, build, and package folders in projects you haven't touched lately.
  • Package manager cachesnpm, Bun, Cargo, Gradle, pip, and friends. Not the pnpm store, which projects share.
  • Left behind by coding agentsnpx packages, Playwright and Puppeteer browsers, older Claude Code versions, idle session temp files.
  • Xcode DerivedDataBuild products and indexes, rebuilt on the next build.
  • Xcode device supportDebug symbols, copied again when you plug the device in.
  • Simulator cachesRebuilt by the Simulator. Simulators and their apps aren't touched.
  • Leftover worktree dataGit's records for worktrees whose folder is gone, like git worktree prune.
  • Editor and chat app cachesVS Code, Cursor, Slack, Discord, Figma. Settings, sign-ins, and history stay.
  • App cachesApps recreate what they need. macOS's own caches are left alone.
  • LogsUseful for troubleshooting, then rarely read again.
Worth a look · unchecked

Your call

  • Ollama, LM Studio, and Hugging Face modelsLocal AI models, each downloadable again.
  • Git worktreesEach shows changes and commits that exist only there. The branch and its commits stay.
  • Old coding agent conversationsClaude Code and Codex chats nobody has opened in 30 days.
  • Build folders in active projectsSafe, but you'll wait for a reinstall or rebuild.
  • Editor data for deleted projectsOpen tabs and, in Cursor, chat history for projects no longer on your Mac.
  • Xcode archivesKeep the ones you still read crash reports for.
  • Screen Studio projectsRaw recordings behind videos you may have already exported.
  • Screen recordingsScreenpipe and Rewind history. Lowering their retention keeps recent days.
  • Virtual machinesParallels, UTM, and VMware, usually many gigabytes each.
  • Disk images and installersDMG, ISO, and PKG files you've already installed from.
  • Big downloadsLarge files and folders in Downloads.
Handed back · their own app

Cleared where it's safe

  • WhatsApp mediaPast 5 GB, with the biggest chats named. A known sync bug can fill it past what WhatsApp shows. Opens WhatsApp.
  • Messages attachmentsPast 2 GB, with the biggest conversations. Trashing them by hand would leave broken attachments. Opens Messages.
  • Signal attachmentsEncrypted and only on your devices, so they can't be downloaded again. Opens Signal.
  • Telegram and Telegram Desktop mediaStill in Telegram's cloud. Its own storage settings clear it by chat.
  • Docker disk imageOne file holding everything Docker stores. Reclaimed with Docker's own prune in System Data, not by deleting the file.

WhatsApp, Messages, and Telegram keep their media in folders macOS guards, so they show up once Full Disk Access is on. Missing a folder you know about? Use Suggest a Rule from the menu.

Nothing goes without asking.

Move to Trash… opens one dialog with the total, what's in each category, and anything that has to stay. Open files stay put, because the app or Claude Code session using them would keep using the trashed copy.

  • Trash by default. Delete Immediately is there when you need the space now, and it says it can't be undone.
  • Undo. It puts back everything the last run moved, from the app or with diskforecast undo, until you quit.
  • Quit and Try Again… It names each app and Claude Code session first. Apps quit the usual way, so one with unsaved work asks, and Claude Code conversations pick up again with claude --resume.
  • Disk too full for the Trash? Moving to the Trash needs a little free space. It tells you, and offers Delete Instead or Empty Trash.
  • Empty Trash… It deletes even what Finder can't, like folders whose paths are too long, after asking with the item count.
  • Home folder only. It moves things inside your home folder, plus Claude Code's own temp sessions. Never your home folder or its standard folders, and never through a link that leads out.

Built for the Macs that fill up fastest.

Some disks fill slowly for years. These fill in a week.

If you write code

Every clone brings a node_modules folder, every Xcode build leaves DerivedData, and coding agents leave worktrees and downloads behind.

  • Build folders in projects untouched for 30 days come checked
  • Git worktrees list what removing each one would lose
  • Simulator runtimes and Docker are fixed with simctl and docker

If you make videos

One project can hold more raw footage than the rest of your disk, and exports double it.

  • Final Cut and other project folders show up in Taking the most space
  • Screen Studio projects you've exported are listed with when they last changed
  • Screenpipe and Rewind history, big downloads, and old installers

If your Mac has 256 GB

There's no slack, so a chat app's media or one local AI model is enough to fill it. Is 256 GB enough?

  • Messages and WhatsApp media, with the biggest chats named
  • Ollama, LM Studio, and Apple Intelligence models
  • A notification a week before it's full, not on the day

Or just ask your agent.

Disk Forecast comes with a diskforecast command, so Claude Code and Codex can answer “why is my disk full?” for you. They see the same forecast, history, and cleanup list you do, and they show you what they'd clear before anything goes to the Trash.

  • “When will my Mac run out of space?”diskforecast status
  • “What filled up my disk this month?”diskforecast changes --days 30
  • “Clear what's safe, but show me first.”diskforecast trash xcode-derived-data package-caches
  • “Here's what I picked. Clear it carefully.”Cleanup › Copy Agent Prompt
Every command, and a line for your CLAUDE.md

Claude Desktop extension

Use Disk Forecast from Claude.

Add Disk Forecast to Claude Desktop and ask in plain words: what's eating my disk, what can I clean up, how fast is it filling. Claude reads the same forecast, history, and cleanup list you see in the app.

The extension only reads. Claude can't move or delete anything through it; clearing space stays in Disk Forecast, where you choose what goes.

Install Disk Forecast first. Then double-click diskforecast.mcpb, or drag it onto Claude Desktop, and choose Install.

The other ways to free up space on a Mac, honestly compared.

Disk Forecast is free. Here it is next to the tools people usually reach for, from the one already on your Mac to the paid cleaners, with what each does better.

Disk ForecastStorage settingsDiskBuddyDaisyDiskCleanMyMacGrandPerspectiveOmniDiskSweeper
PriceFreeBuilt in$9 once for 400 launch copies, then $49$9.99 once, up to 5 MacsSubscription or one-time license, from $3.33 a monthFree, or $2.99 on the App StoreFree
Tells you when the disk will be fullYes——————
Notifies you before the disk fillsYes, a week ahead or when low———Reminds you about cluttered drives from its menu——
System Data explainedYes, item by item, with fixesSize only“You can't manage the contents”A guide on its siteAdmin scan reaches restricted folders———
Shows which folders grew, and whenYes, day by day—Compares a saved scan with today————
Cleanup that says why each item is safeYes, 29 rulesRecommendationsiCloud, Optimize Storage, empty Trash after 30 daysCaches, build files, and old installers—Smart Care and cleanup tools——
Visual map of the diskNo, ranked listsOne bar by category—Yes, rings—Yes, a treemapNo, a sorted list
Malware, uninstaller, app updatesNo—Applications view—Yes——
Command line for scripts and AI agentsYes, diskforecast——————
Source availableYes, on GitHubNo—NoNoYes, GPL—
Runs onmacOS 14 or laterEvery MacmacOS 14 or later, and WindowsmacOS 10.13 or latermacOS 11 or latermacOS 14 or later3.7.2 for macOS 11 to 13macOS 11 or later

“—” means we couldn't confirm it on the vendor's own site. Checked November 16, 2026, at support.apple.com, diskbuddy.com, daisydiskapp.com, macpaw.com, grandperspectiv.sourceforge.net, and omnigroup.com. More detail: every comparison.

Careful by default.

Nothing is deleted without asking, nothing leaves your Mac, and nothing costs a thing.

Trash first

What you clear goes to the Trash, where you can put it back. Delete Immediately and Empty Trash are there when you need the space now, and both ask first.

Apple's own tools

System fixes run tmutil, mdutil, or xcrun simctl, and show you the command first.

Counted once

APFS clones and hard links share space on disk, so they're counted once and totals aren't inflated.

Home folder is enough

Full Disk Access is optional. Cloud drives like Dropbox are never scanned.

Stays on your Mac

No telemetry, no account. The only network call checks for updates, and you can turn it off.

Free. Really.

No trial, no subscription. Source on GitHub, signed and notarized by Apple.

What it reads

  • Names and sizes of the files in your home folder. To name your biggest chats, it reads WhatsApp's and Messages' own databases on your Mac, read-only.
  • Free space on the startup disk, once an hour.
  • With Full Disk Access, the folders macOS guards: Mail, Messages, Safari, iCloud Drive, and other apps' containers.
  • Its own history in ~/Library/Application Support/Disk Forecast: a reading a day and folder sizes, 120 days of each.

What it never does

  • Scan cloud drives in ~/Library/CloudStorage, like Google Drive, Dropbox, and OneDrive.
  • Download iCloud files that macOS offloaded to make room.
  • Ask for Photos, Music, or TV access. Without Full Disk Access, those libraries are skipped.
  • Send anything about your disk anywhere. There's no analytics in the app.

What it asks for

  • Full Disk AccessOptional. Without it, macOS asks once each for Desktop, Documents, and Downloads.
  • NotificationsThe first time it has something to warn you about.
  • Your passwordOnly to rebuild the Spotlight index, and macOS asks, not the app.
  • Launch at loginOn from the first launch, so readings continue after a restart. Off in Settings.

Free. Nothing to sign up for.

No account, no trial, no subscription, and no ads, at home or at work. A tool you let near your files should show its work, so every rule, every count, and every move to the Trash is in the source.

$0At home or at work. Nothing to sign up for, nothing to cancel.
FSL-1.1-MITSource available today, and each release becomes MIT-licensed two years after it ships. View source
—GitHub stars, live. Add yours.
4.6 MBThe whole download. Native Swift, one app for Apple silicon and Intel.
0Trackers, analytics, or accounts. The only network call checks for updates, and you can turn it off.
NotarizedSigned with Developer ID and checked by Apple, every release. macOS 14 Sonoma or later.
New in 1.10

A storage meter.

The menu card now shows what your used space is made of: apps, developer files, photos, movies, documents, music, caches, system, and the Trash, each counted once so they add up. Hover a category to see what it counts. Choose a Peak meter of LED dots or a VU meter in Settings › General. Empty Trash… sits right under it and still asks first. Release notes

Questions

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.

Know before it's full.

Free for any Mac on macOS 14 or later. No account, no subscription.

macOS 14 or later · Apple Silicon and Intel · brew install --cask coreyhaines31/tap/diskforecast

Or install it with Claude Code or Codex

Paste this into a coding agent that can run commands on your Mac.

Install Disk Forecast, a free macOS menu bar app (https://github.com/coreyhaines31/diskforecast), on this Mac:

1. Check that macOS is 14 or later with `sw_vers -productVersion`. If it's older, stop and tell me.
2. If Homebrew is installed (`command -v brew`), run:
   brew install --cask coreyhaines31/tap/diskforecast
   Otherwise, install the latest release from GitHub:
   url=$(curl -fsSL https://api.github.com/repos/coreyhaines31/diskforecast/releases/latest | grep -o 'https://[^"]*\.dmg' | head -1)
   curl -fsSL -o /tmp/DiskForecast.dmg "$url"
   mnt=$(mktemp -d) && hdiutil attach -nobrowse -quiet /tmp/DiskForecast.dmg -mountpoint "$mnt"
   cp -R "$mnt/Disk Forecast.app" /Applications/ && hdiutil detach -quiet "$mnt" && rm /tmp/DiskForecast.dmg
3. Check it's notarized: `spctl --assess --type exec -v "/Applications/Disk Forecast.app"` should say "Notarized Developer ID".
4. Open it: `open -a "Disk Forecast"`.
5. Open the Full Disk Access settings for me:
   open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"
   Then tell me to turn on Disk Forecast there (it's optional), that its tape reel icon with my free space is now in the menu bar, and that from now on I can ask you why my disk is filling up or what's safe to clear. You'll use the `diskforecast` command (see `diskforecast --help`; if it isn't on the PATH, it's at "/Applications/Disk Forecast.app/Contents/MacOS/diskforecast").

Don't change any other settings and don't delete anything.
Corey Haines
Why it exists

I build a lot of side projects, and my Mac kept filling up without warning. Storage settings lumped most of it into System Data and stopped there, and the tools that explain it cost $10 to $49. When I finally looked, 99 GB of my disk was build folders from projects I hadn't touched in a month. So I built the app I wanted: it warns me weeks ahead, explains where the space went, and asks before anything is deleted. And it's free.

Corey Haines, maker of Disk Forecast and more free Mac apps