DiskSpace AI

com.diskspaceaiPublished by diskspaceai.comv1.0.27Updated Nov 5, 2026

Analyze a Mac's disk, explain each folder and clean what recreates itself, with 7-day undo.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Lets an AI assistant analyze a Mac's disk usage, explain what each folder is, and propose a cleanup with a 7-day undo.

What you can do
  • Analyze disk usage and identify what each folder is, including caches, build data, node_modules, Docker and AI models
  • Propose a cleanup, selecting only items that recreate themselves and flagging user data as view-only
  • Set aside deleted files for 7 days so they can be restored
  • Find duplicate and similar photos, screenshots, videos and bursts
  • Archive unused items into a verified .zip instead of deleting them
  • Explore a folder tree and size-sorted table with Quick Look and filtering
When to use it
Useful when a Mac is running low on space and you want an assistant to explain what is taking up room and suggest a safe cleanup, rather than deleting folders blindly.
Requirements
A local MCP server (stdio) that works with the DiskSpace AI Mac app; the app requires macOS 15 or later on Apple silicon or Intel. No environment variables, headers or authentication are declared.
Before you install
The assistant can propose and carry out cleanup that deletes or sets aside files; the README says agents always ask before cleaning, but confirm this behavior. Deleted items are recoverable only for 7 days. The app itself is not open source, and the beta's free Pro period ends December 31, 2026.

Installation

In SourceWeft

  1. Open DiskSpace AI in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[DiskSpace AI]

DiskSpace AI

Free up space on your Mac without fear.
It tells you what every folder is and only selects what recreates itself. Your files are kept for 7 days, in case you change your mind.

[Version 1.0.27] [macOS 15+] [Apple silicon and Intel] [Free beta]

Website · Download the beta · Interactive demo · For AI agents (MCP) · Español

[Animation: a full disk, the color map, green items get selected and space is freed]

This repository is DiskSpace AI's public documentation: the catalog of folders the app knows, how to connect it to your AI agent, the release notes, and the place to report bugs or request features. The app itself is not open source.

What it does

  • It knows what every folder is. uv, npm, pnpm and Homebrew caches, Xcode build data, node_modules from idle projects, Docker, AI models, simulators, installers you already used… The ones it doesn't know are explained by Apple's AI, on your Mac.
  • Four colors, one rule. Green recreates itself and comes selected; amber is for review; gray is your data and is only shown; purple is unclassified.
  • With a safety net. What recreates itself is deleted right away; your files are set aside for 7 days and can be restored.
  • Duplicate and similar photos. In your Photos library and your folders: exact duplicates, near-identical shots (Apple's Vision picks the best one, on your Mac), old screenshots, big videos and bursts.
  • Archive instead of delete. What you don't use but want to keep goes into a .zip that's fully verified before the original is set aside.
  • An Explorer with sizes. A folder tree and a table sorted by size, with Quick Look and a filter: what Finder doesn't show you.
  • Honest numbers. APFS clones and hard links are counted once, and Docker shows what it really takes up.
  • For your AI agent. Claude Code, Claude Desktop, Codex or Cursor can analyze the disk and propose a cleanup; they always ask before cleaning. How to connect it
  • Your files never leave your Mac. No analytics or tracking.

[DiskSpace AI window: disk map colored by safety and list of what can be cleaned]

Download

DiskSpace AI 1.0.27 for Mac · macOS 15 or later · Apple silicon and Intel. During the beta, Pro is free until December 31, 2026. Install steps on the beta page.

Signed and notarized by Apple. Also with Homebrew:

sh
brew install --cask diskspaceai/tap/diskspace-ai

The app updates itself. What changes in each version is in CHANGELOG.md.

In this repository

folders/README.mdThe folders the app knows: what each one is, whether you can delete it and how (also as JSON)
mcp/README.mdConnect DiskSpace AI to your AI agent (MCP server)
CHANGELOG.mdRelease notes for every version
IssuesReport a bug or request a feature

Help and contact

The folder catalog and documentation are licensed under CC BY 4.0 (see LICENSE). DiskSpace AI is not affiliated with Apple. Mac and macOS are trademarks of Apple Inc.

Source: README.md at commit 192106a

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

5
  1. v1.0.27LatestNov 4, 2026
  2. v1.0.26Nov 4, 2026
  3. v1.0.25Nov 3, 2026
  4. v1.0.23Oct 31, 2026
  5. v1.0.19Oct 29, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.