mac-disk-scan 🔍 v2

Fast parallel scanner for macOS that finds large & unused files to help free up disk space. Scans 20+ dimensions in ~15 seconds.

What's New in v2

• 🚨 Junk detection — AppleDouble files (._*), incomplete downloads (.downiepart), git tmp_pack
• 🍺 Homebrew scanning
• 🇨🇳 Chinese dev tools — OpenHarmony SDK, ArkUI-X, Hvigor
• 🤖 AI tools detail — Claude vm_bundles breakdown, CodeBuddy, Cursor
• ⚙️ Extended dev caches — .rustup, .fastlane, .codex, .claude-voice, .workbuddy, .jenkins
• 📥 Downloads split view — directories and files listed separately
• 🖥️ Desktop split view — directories and files listed separately

Quick Start

# One-shot scan (no install)
curl -fsSL https://raw.githubusercontent.com/neoliou/mac-disk-scan/main/disk-scan | bash

# Or install globally via npm
npm install -g @panda_neo/disk-cleaner
disk-scan

What It Scans

| Category | What | |----------|------| | 🏠 Home | Top-level directory sizes (including hidden) | | 📚 Library | Full ~/Library breakdown | | 🍎 Xcode | DerivedData, DeviceSupport, Simulators, Archives | | 📦 App Support | Top 20 apps (Claude, Chrome, DingTalk, Lark, etc.) | | 📱 Containers | Top 20 app containers (WeChat, etc.) | | 🗑️ Caches | Top 20 cache directories | | 📥 Downloads | Split: directories + files, top 25 each | | 📄 Documents | Top 25 document directories | | 🖥️ Desktop | Split: directories + files, top 25 each | | ⚙️ Dev Caches | 20+ dev tools (.npm, .cocoapods, .gradle, .cargo, .rustup, .fastlane, .codex, .hvigor, etc.) | | 📧 Mail | Apple Mail + Messages storage | | 🍺 Homebrew | /opt/homebrew and Cellar sizes | | 🚨 Junk | AppleDouble, .downiepart, git tmp_pack, Trash, system logs | | 🇨🇳 Chinese Dev | OpenHarmony, ArkUI-X, Hvigor | | 🤖 AI Tools | Claude vm_bundles detail, CodeBuddy, Cursor | | 📦 Large Files | Files >200MB (Downloads, Desktop, Documents) | | 📂 Git Repos | Oversized .git directories | | 📦 node_modules | Scattered node_modules folders |

Claude Code Integration

This package is also a Claude Code skill. Install as a skill:

cp SKILL.md ~/.claude/skills/disk-cleaner/
cp disk-scan ~/.claude/skills/disk-cleaner/scan.sh

Then invoke with /disk-cleaner in Claude Code.

Pro Tip: Parallel Bash Mode

In Claude Code, use parallel Bash tool calls for faster scanning (bypasses script overhead):

// Launch 10+ parallel du commands simultaneously
du -sh ~/* ~/.[!.]* | sort -rh | head -20
du -sh ~/Library/*/ | sort -rh | head -20
du -sh ~/Library/Developer/Xcode/*/
...

Each call is independent — Claude Code runs them all at once.

Safety

• Read-only — only scans, never deletes
• Local only — all data stays on your machine
• No personal data — uses $HOME generically, no hardcoded paths
• Transparent — single bash script, you can audit it

License

MIT