English Français العربية

DiskSpace AI

Official registry AI and agents

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

Source code Website Documentation

What can you do with DiskSpace AI?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/diskspaceai/diskspace-ai/releases/download/v1.0.18/diskspace-ai-1.0.18.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. DiskSpace AI
  2. What it does
  3. Download
  4. In this repository
  5. Help and contact

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.

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

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.

Download

DiskSpace AI 1.0.16 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:

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.

Frequently asked questions

What is DiskSpace AI?

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

How do I install DiskSpace AI?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does DiskSpace AI need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is DiskSpace AI open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains DiskSpace AI?

It is published by diskspaceai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.