Mint for Mac
Smart disk and memory. For you and your agents.
Mint is a Mac app that keeps disk and memory healthy for you and the AI agents working on your Mac. Coding agents fill the disk with conversations, worktrees, build output and caches, and leave apps and headless browsers running that hold memory. Mint judges each item before it offers anything: which agent or app it came from, whether it is still in use, whether it would come back on its own. Mint 1.2 also finds worktrees that can be made again, old app builds and leftover simulator copies.
With this plugin, Claude asks Mint what grew and what is safe to free, then gets space back, much of it without deleting a file (identical copies share their storage, idle files are compressed in place), moves what is safe to clean to the Trash and frees memory from idle apps, through the Mint app's own engine and checks. Anything that deletes for good, quits an app or changes Mint's settings waits until you confirm it in Mint's window on the Mac, and Mint keeps a record of what it moved, so it can be put back while the items still exist.
The plugin starts Mint's own MCP server on this Mac. Every tool runs locally, inside Mint.
Requirements
- macOS 14 or later.
- Mint for Mac 1.2.0 or later, the edition from mintstorage.app/download. Open it once after installing. The Mac App Store and Setapp editions don't include the command-line tool this plugin starts. Earlier versions of Mint offer only a few of the tools below.
- Claude Code, or Cowork running on the Mac. Claude chat, on the web, in the desktop app and on phones, doesn't start local servers, so the plugin has no tools there.
Scans, reports and previews are free. Cleaning, optimizing and organizing count toward Mint's free 1 GB a week; Mint Unlimited removes that limit.
Install
In a shell:
claude plugin marketplace add dzg-studio/mint-claude-plugin
claude plugin install mint-for-mac@dzg-studio
Then start a new Claude Code session. /mcp lists the mint server and its tools.
Tools
| Area | Tools | What Claude can do |
|---|
| Overview | mint_status, mint_why, mint_history, mint_recent, mint_activity, mint_capabilities, mint_access | Disk use over time and what grew, past work, which operations this Mint offers, and how much of the free allowance is left |
| AI tools | mint_agents, mint_conversations_scan, mint_conversations_optimize, mint_conversations_remove_media, mint_conversations_delete, mint_archives_optimize | What Codex, Claude Code, Cursor and other AI tools keep on this Mac, and how much their conversations and archives take |
| Disk | mint_disk_scan, mint_disk_clean, mint_scan, mint_execute, mint_trash_scan, mint_trash_remove | Scan the Mac the way the Disk page does, clean reviewed items, and review or empty selected Trash entries |
| Space back without deleting | mint_storage_scan, mint_storage_optimize, mint_sharing_scan, mint_sharing_execute | Share storage between identical copies and compress files in place; every file keeps its name and contents |
| Memory | mint_memory_scan, mint_memory_release | What uses memory, and quitting the apps chosen from Mint's list |
| Auto Care | mint_autocare_status, mint_autocare_disk, mint_autocare_folder, mint_autocare_memory | See and set what Mint takes care of on its own |
| Conversation pictures | mint_compression_scan, mint_compression_execute, mint_pictures_scan, mint_picture_file_scan, mint_picture_preview, mint_pictures_keep, mint_pictures_remove | Find the pictures inside AI conversations, preview one, keep some and remove the rest while the text stays |
| Apps | mint_apps_list, mint_uninstall_scan, mint_uninstall_execute |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
