Claude Code · free up space

Free up space with Claude Code, safely

Switch Claude Code on in Atzu Storage's Settings and press Ask AI after a scan. Claude reads the scan and Atzu Storage's rating of what each thing costs to remove, and suggests specific items. Atzu Storage marks them in its own lists, ticked, and nothing is cleaned until you press Clean.

What it did on a full developer Mac

On 13 November 2026 the Mac this app is built on had 3.2 GB free of 228 GB, 99% full. Asked "what's taking space on my Mac?", Claude Code ran Atzu Storage's storage report, looked inside the three biggest categories rated safe or worth reviewing, and came back with a plan in 137 seconds. Asked to go ahead, it checked which projects were in use before touching any. What made it worth trusting is what it left alone:

  • 56 project build folders, 16.8 GB. It kept every project in use that day, with a dev server running or a commit from that day, and cleaned only four idle ones.
  • Five build folders holding finished builds, an Android .aab and .apk and three Xcode archives. Atzu Storage's notes flag those, and Claude said to copy them out first.
  • Three Android NDK versions, 8.2 GB. Two are used by projects, and Atzu Storage's notes say which, so it kept them. It suggested only the one no project uses (2.6 GB).

With the owner's go-ahead that came to 21.5 GB: 4.7 GB of idle build folders and the unused NDK, and 16.8 GB of iOS Simulator files the owner chose to remove. Free space went from 1.1 GB (other work had used more in the meantime) to 22 GB.

That run came before Atzu Storage could take Claude's suggestions, so Claude Code carried out the clean itself, and removed the simulator with Xcode's own tool. Now the same suggestions are marked in Atzu Storage's lists instead, which is the whole point of the next section.

Why an assistant should not delete files itself

Claude Code can already delete files on its own. What it cannot know is what each folder costs to remove: whether a cache regenerates, whether a build folder holds the only copy of a finished app, or whether an SDK version is still used by a project. Atzu Storage rates every category it measures, and notes each item with what it is and how to get it back.

Connected, the two divide the work:

  • Claude reads and suggests. It sees the scan, the safety ratings and Atzu Storage's note on every item, and picks items, not whole categories.
  • Atzu Storage checks and marks. It keeps only items its own scan found, and marks them where you already work: a blue AI mark on the safety level and on the category's Details button, and the category's list opens with Claude's items ticked beside the app's own note on each.
  • You decide. Untick anything you want to keep and press that list's usual Clean. It cleans with each category's own method (delete, Trash, or Xcode's tool), after the usual confirmation.

Anything rated Move to Backup or Protected, such as your Photos library or chat history, can't be suggested at all. Neither can uninstalling an app.

How to connect them

  1. Update to the latest version from this site. Up to 1.4.2 the app was still called RefreshYourMac, so the menu is RefreshYourMac › Check for Updates; after the update it calls itself Atzu Storage. It needs a licence to list file names and to clean.
  2. Open Settings, then AI, and switch on Claude Code. If Claude Code is on your Mac, Atzu Storage also offers this once, after its first scan.
  3. Press Ask AI, under Clean All Safe.

What Ask AI does

Atzu Storage starts Claude Code in the background, signed in to your own Claude account, and hands it the scan. You don't see a terminal. While it works, Ask AI shows what it is looking at and roughly how long is left, worked out from your earlier runs, and the rest of the window keeps working. A run takes a few minutes.

  • It can only use Atzu Storage's tools. No shell, no reading or changing files, and none of the other tools you may have added to Claude Code. That is set when Atzu Storage starts it, not left to the request.
  • It runs on Haiku, Anthropic's smallest model, whatever your usual model is. On the same scan it read more categories than Sonnet and cost about a seventh as much.
  • The answer is a list of places to look: how much was marked, grouped by safety level, and each category opens with its items ticked.

Codex, from the ChatGPT app

Codex, the coding assistant that comes with OpenAI's ChatGPT app, works the same way: switch it on in Settings, AI, and Ask AI runs it in the background, on your ChatGPT account, with its answer in the window. It is held to the same limits, Atzu Storage's tools and nothing else. ChatGPT's ordinary chat can't connect: it reaches only services on the internet, and Atzu Storage keeps the scan on your Mac.

Other assistants

The same Settings tab can connect the Claude app. Ask AI then runs Claude in the background the same way, with the copy of Claude Code that the Claude app keeps for its Code tab, so it needs nothing else installed. Until that Code tab has been used once, Ask AI opens a Claude chat with the request ready instead. You can also add Atzu Storage to Claude Code by hand, in Terminal, though Settings › AI does it for you and picks the right path. A copy downloaded since the rename is Atzu.app:

claude mcp add --scope user refreshyourmac -- /Applications/Atzu.app/Contents/MacOS/RefreshYourMac --mcp

A copy that came as RefreshYourMac and updated itself keeps its old file name:

claude mcp add --scope user refreshyourmac -- /Applications/RefreshYourMac.app/Contents/MacOS/RefreshYourMac --mcp

It works as an MCP server, the standard way AI tools connect to apps, so other assistants that support MCP can use the same command.

What Claude can ask Atzu Storage

  • The storage report: every category, its rating, size and item count. A full scan takes about two minutes.
  • One category's items, with each item's note and path.
  • The scheduled clean's plan: what it would clean now and what it would skip, and why.
  • Duplicate files, what is using memory, and what is still running, such as simulators and leftover log watchers.
  • The maintenance tasks and what each would do.
  • Whether this Mac is licensed. Never the licence key.
  • A suggested clean, which Atzu Storage marks in its lists as described above.

Privacy

Atzu Storage answers Claude on your Mac and sends nothing over the network itself. Claude Code, including when Ask AI starts it, sends what it reads to Anthropic, so the file names and paths it asks about reach Anthropic under Anthropic's terms. Your licence key never does. Theprivacy page has the details.

The Mac App Store version can't be connected: its sandbox lets it see too little of the disk for the answers to be useful.

Claude and Claude Code are made by Anthropic. Atzu Storage is made by Caddora and is not affiliated with Anthropic.

What to do next: see these numbers for your own Mac. Download Atzu Storage free, or get it on the Mac App Store.

What it costs to have an app do this

Atzu StorageCleanMyMacMacKeeper
Pay once$24.99€119.95 on MacPaw’s store; $89.99 for CleanMyMac X on the Mac App Storesubscription only
Yearly$14.99 a year, first 7 days free$39.99/yr on the Mac App Store; €39.95/yr on MacPaw’s store€71.40 for the first year, 1 Mac. Their page shows it against a €119.40 list price
Monthly$1.99 a month$9.99/mo€10.95/mo
Account neededNoYesYes

Both versions' yearly plans start with 7 days free. CleanMyMac and MacKeeper prices read from their own pages and the Mac App Store on 27 October 2026; the full comparison is at Atzu Storage vs CleanMyMac and MacKeeper.