给 AI Agent 用
让你的 AI Agent 通过 Mint 清理文件
让 Claude Code、Codex 这类 Agent 帮你收拾 Mac，它多半会直接用 rm，删完没有记录，也找不回来。Mint 直销版带了命令行工具 mint-cli 和一个本地 MCP 服务。Agent 可以先问 Mint 空间被谁占了、为什么变多；它执行的清理会移到废纸篓并记进 Mint 的日志，之后还能撤销。
直销版里有什么
Mint 直销版每次启动时，会把 mint-cli 链接到 /opt/homebrew/bin 或 /usr/local/bin 中它有写入权限的那个目录，所以在任何终端里都能直接用。mint-cli status 能看到最近几次扫描之间磁盘占用的变化，mint-cli why 告诉你什么在变大，mint-cli scan 会列出能清掉的缓存和垃圾文件。mint-cli agents 则汇报 Codex、Claude Code 和 Cursor 在磁盘上存了多少东西。
Mac App Store 版和 Setapp 版都没有 CLI 和 MCP 服务。Agent 通过 Mint 做的清理，和在应用里清理算同一份清理额度。
通过 MCP 连接你的 Agent
运行 mint-cli mcp 会启动一个 MCP 服务，通过标准输入输出和 Agent 通信。它在你的 Mac 本地运行。扫描和清理交给 Mint 应用来做，其他工具读的是 Mint 已经存在本地的数据。
- 从 Mint 官网下载直销版，先打开一次。
- 在终端运行 mint-cli status，确认能看到磁盘摘要。
- 在 Agent 的 MCP 设置里加一个服务，命令填 mint-cli，参数填 mcp。
- 重启 Agent，问问它你的 Mac 空间都用在了哪里。
Agent 能看到什么
这个服务一共有八个工具。mint_status 和 mint_why 负责磁盘趋势和增长来源。mint_scan 调用 Mint 自己的只读清理扫描，每一项都会附上原因，并标明 Agent 能不能处理。
mint_recent 和 mint_activity 读取操作日志和活动记录，mint_agents 读取 Mint 最近一次 AI Agent 扫描的结果，mint_rules 会列出你的清理规则，也能试运行其中一条。这些工具都不会改动磁盘。
Agent 动手清理时会发生什么
真正会改动文件的只有 mint_execute。它要用到最近一次 mint_scan 返回的计划 ID、Agent 挑出的项目 ID，再加一句说明原因的话，而且不接受文件路径。计划 15 分钟后失效，只能用一次。动每个文件之前，Mint 还会再确认一遍，确保还是同一个文件、没有程序在用，而且仍然允许清理。
所有文件都会移到废纸篓，就算应用里设置了永久删除也一样。返回结果里有日志的批次 ID，之后可以在 Mint 里找到这一批并撤销，日志最多保留 90 天。文件在废纸篓里仍然占空间，清空后才会腾出来，所以结果会把这部分单独列出。
忽略列表对 Agent 同样有效
你在 Mint 忽略列表里给路径设的级别，Agent 来问时也照样生效。设为“受保护”的路径，Agent 的扫描里根本看不到。设为“需要确认”的路径可能出现在结果里，但 Agent 删不了，得你回到应用里确认。
有了日志，Agent 做过什么都查得到，大多数时候也能撤回，可它没法保证 Agent 每次都判断对。重要的工作请继续用版本控制和备份保护好。
常见问题
哪些 Mint 版本有 CLI 和 MCP 服务？
只有从 Mint 官网下载的直销版有。Mac App Store 版和 Setapp 版都没有。
Agent 能通过 Mint 永久删除文件吗？
通过 MCP 工具不行。mint_execute 只会把文件移到废纸篓，需要永久删除的项目会留在 Mint 应用里等你处理。
连上 Mint 以后，Agent 就不会再用 rm 了吗？
不一定。MCP 服务会让 Agent 用 mint_execute 来清理，但它拦不住 shell，所以 Agent 自己的权限设置请照常保留。
先拿一次小清理试试
安装 Mint 直销版，把 mint-cli mcp 接到你的 Agent，让它清掉一个开发缓存。然后在 Mint 里打开这一批，看看它做了什么。