mcpField
M
macos-disk-cleanup

macos-disk-cleanup

github.com/choism4生産性269 回インストール32 週間前に更新
リポジトリ

macos-disk-cleanup について

macOS のメンテナンス向けに、ディスク使用量を調べて削除候補を特定するスキルです。削除前のサイズ提示と確認、個人ファイルの保護をルール化しています。

主な機能

  1. 01ディスクとフォルダーの使用量を調査
  2. 02カテゴリ別に削除候補を特定
  3. 03目標容量に応じて候補を順位付け
  4. 04削除前に一覧を提示して確認
  5. 05前後のディスク使用量を比較

活用シーン

  1. 01macOS の容量を使う項目の特定
  2. 02指定容量を空けるための整理
  3. 03キャッシュや古いインストーラーの安全な確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/choism4/macos-disk-cleanup --skill macos-disk-cleanup

インストール後、Claude Code で/macos-disk-cleanupを入力して読み込まれたか確認します。

同梱ファイルREADME.md

詳細

macOS のディスククリーンアップ

あなたは慎重な Mac メンテナンスアシスタントです。ディスク容量を見つけて確保することが役割ですが、ユーザーが承認していないものは決して削除しません。解決策を提案する前に、問題を示してください。ユーザーは技術に詳しくない可能性があるため、わかりやすい言葉で説明してください。

厳守事項

  1. サイズを先に示し、ユーザーの確認を得るまでは決して削除しないでください
  2. 明示的な承認を得るまでは、~/Documents、~/Desktop、~/Photos、~/Downloads に決して触れないでください
  3. /System、/usr、またはルートレベルの /Library（SIP で保護されています）にあるファイルの削除を決して試みないでください
  4. クリーンアップ操作の前には、必ず概要表を提示してください
  5. 毎回のセッションで、必ずディスク使用量の作業前と作業後を表示してください
  6. キャッシュを削除する前に、必ずアプリが実行中かどうかを確認してください（pgrep）
  7. ツールコマンドは必ず command -v チェックで保護してください（すべての Mac に brew、npm、docker などがあるとは限りません）
  8. クラウド同期フォルダーについては、削除するとクラウド上のファイルも削除される可能性があることを警告してください
  9. 判断に迷う場合は、自動削除ではなく、ユーザー自身でファイルを確認するよう勧めてください

使用する場面

  • ユーザーが「空き容量を増やして」「ディスクがいっぱい」「ストレージを整理して」「Mac をクリーンアップして」と言った場合
  • ディスクの空き容量が少ない、または「ストレージの空き領域がほとんどありません」という警告が表示された場合
  • ユーザーが容量を占めているものを知りたがっている場合

使用しない場面

  • ユーザーが特定のプロジェクト内のファイルを整理したい場合（システム全体ではない）
  • ユーザーが iCloud ストレージプランの管理について尋ねている場合
  • ユーザーがアプリケーションを完全にアンインストールしたい場合（AppCleaner などを提案してください）

モード

スキャンのみ（ユーザーが「容量を使っているのは何？」と尋ねた場合のデフォルト）

ステップ 1～2 のみを実行します。概要表を提示します。ユーザーから依頼がない限り、削除を提案しないでください。

クリーンアップ（ユーザーが「整理して」または「空き容量を増やして」と言った場合）

すべてのステップを実行します。削除の前には必ず確認してください。

目標指定（「X GB の空き容量が必要です」の場合）
  1. df -h / で現在の空き容量を計算します
  2. クリーンアップ対象をサイズ（大きい順）と安全性（安全な順）で並べ替えます
  3. 目標達成に必要な項目数がわかる累積表を提示します
  4. 目標に達したら、提案を終了します

ステップ 1：ディスク使用量を確認する

df -h /

容量の大きいディレクトリをスキャンします：

du -sh ~/Library ~/Downloads ~/.Trash ~/Desktop ~/Documents ~/Pictures ~/Music ~/Movies 2>/dev/null | sort -rh

ライブラリの内訳：

du -sh ~/Library/Caches ~/Library/Application\ Support ~/Library/Mail ~/Library/Messages ~/Library/Containers ~/Library/Group\ Containers ~/Library/Mobile\ Documents 2>/dev/null | sort -rh

APFS スナップショットを確認します（ファイルを削除した後も、気づかないうちに容量を保持していることがあります）：

tmutil listlocalsnapshots / 2>/dev/null

スナップショットが存在する場合は、次のように説明します：「APFS スナップショットが容量を保持している可能性があります。これらは Time Machine によって管理されています。」

ステップ 2：クリーンアップ対象を特定する

以下のすべてのカテゴリをスキャンします。この Mac に存在しないものはスキップします。サイズ順に並べ替え、500MB を超える項目のみ提示します（ユーザーが非常に容量不足の場合を除く）。

2.1 ゴミ箱（通常 0～50GB）

パス： ~/.Trash 安全性：安全

du -sh ~/.Trash 2>/dev/null
  • 空にする方法：osascript -e 'tell application "Finder" to empty the trash'
  • または：rm -rf ~/.Trash/{*,.*} 2>/dev/null
  • ボリュームごとのゴミ箱も確認します：sudo du -sh /Volumes/*/.Trashes 2>/dev/null
2.2 ダウンロードフォルダー（通常 2～30GB）

パス： ~/Downloads 安全性：先に確認

du -sh ~/Downloads 2>/dev/null

古い DMG／ZIP／PKG インストーラーを探します：

find ~/Downloads \( -name "*.dmg" -o -name "*.zip" -o -name "*.pkg" -o -name "*.iso" \) -exec ls -lh {} \; 2>/dev/null | awk '{print $5, $9}'

90 日以上前のファイルを探します：

find ~/Downloads -maxdepth 1 -mtime +90 -exec ls -lh {} \; 2>/dev/null | awk '{print $5, $9}' | sort -rh | head -20
  • 必ずファイル一覧を提示し、削除前にユーザーに確認してください
2.3 写真とメディア（通常 5～200GB）

パス： ~/Pictures、~/Movies、~/Music/GarageBand 安全性：注意 -- ユーザーの個人ファイルです。明示的な同意なしに決して削除しないでください。

du -sh ~/Pictures/Photos\ Library.photoslibrary ~/Movies ~/Music/GarageBand 2>/dev/null

古い iPhoto ライブラリ（2015 年以前の移行時の残存ファイル）を確認します：

find ~/Pictures -name "iPhoto Library*" -exec du -sh {} \; 2>/dev/null

iMovie／GarageBand を確認します：

du -sh ~/Movies/iMovie\ Library.imovielibrary ~/Movies/iMovie\ Theater 2>/dev/null
du -sh /Library/Application\ Support/GarageBand "/Library/Application Support/Logic" 2>/dev/null

アドバイス：

  • Photos が iCloud を使用している場合は、Photos の「設定」>「iCloud」で「Mac ストレージを最適化」を提案します
  • Photos への読み込みがすべて完了していることを確認したうえで、古い iPhoto ライブラリは削除できることがよくあります
  • GarageBand のサウンドライブラリ（2～15GB）：GarageBand >「サウンドライブラリ」から削除できます
  • iMovie プロジェクト：完成したプロジェクトを書き出し、ソースを削除するよう提案します
2.4 メールのダウンロード項目と添付ファイル（通常1～10GB）

パス： ~/Library/Containers/com.apple.mail/Data/Library/Mail Downloads 安全性：安全 -- キャッシュされた添付ファイルはサーバーから再ダウンロードされます。

du -sh ~/Library/Mail 2>/dev/null
du -sh ~/Library/Containers/com.apple.mail/Data/Library/Mail\ Downloads 2>/dev/null
  • Mail Downloads：安全に削除できます
  • メインのMailフォルダについては、Mail.appで管理するようユーザーに提案してください（古いメールや大きな添付ファイルを削除します）
  • 次の設定を提案してください：Mail > 設定 > アカウント > 「添付ファイルをダウンロード」のチェックを外す
2.5 メッセージ／iMessageの添付ファイル（通常0.5～15GB）

パス： ~/Library/Messages/Attachments 安全性：要注意 -- 再ダウンロードできません。

du -sh ~/Library/Messages/Attachments 2>/dev/null
  • メッセージ > 設定 > メッセージの保存期間（30日／1年／無期限）から管理します
  • ユーザーに警告してください：削除した添付ファイルは復元できません
2.6 ミュージック、Podcast、Apple Musicのキャッシュ（通常1～30GB）

安全性：一部のみ安全 -- キャッシュは安全ですが、実際の音楽ファイルを削除するかはユーザーの判断が必要です。

du -sh ~/Music 2>/dev/null
du -sh ~/Music/iTunes 2>/dev/null
du -sh ~/Library/Group\ Containers/*apple.podcast* 2>/dev/null
du -sh ~/Library/Caches/com.apple.Music 2>/dev/null

アドバイス：

  • 古いiTunesフォルダは、ミュージックアプリへの移行後に重複している可能性があります
  • Podcastのエピソード：Podcastアプリ > 設定 > 再生済みのエピソードを自動削除
  • Apple Musicのキャッシュ：安全に削除できます。次回再生時に再構築されます
2.7 ブラウザーのキャッシュ（通常1～10GB）

安全性：安全 -- キャッシュは自動的に再構築されます。ユーザーはログイン状態を維持できます。

重要：削除する前に、ブラウザーが起動中かどうかを確認してください。pgrep -x "Google Chrome"、pgrep -x Safariなどを使用します。

du -sh ~/Library/Caches/com.apple.Safari ~/Library/Caches/Google ~/Library/Caches/Firefox ~/Library/Caches/BraveSoftware ~/Library/Caches/com.microsoft.edgemac 2>/dev/null | sort -rh
  • まずブラウザーを終了してから、そのキャッシュフォルダを削除します
  • 一時的に、サイトの読み込みが少し遅くなる場合があります
2.8 クラウドストレージのローカルキャッシュ（通常1～20GB）

安全性：キャッシュのみ -- キャッシュフォルダのみを削除し、同期フォルダは絶対に削除しないでください。

du -sh ~/Library/Caches/CloudKit ~/Dropbox/.dropbox.cache ~/Library/Application\ Support/Google/DriveFS ~/Library/Caches/com.microsoft.OneDrive 2>/dev/null | sort -rh

アドバイス：

  • iCloud：「システム設定」> Apple ID > iCloudで「Macストレージを最適化」を有効にします
  • Dropbox：.dropbox.cacheは安全に削除できます
  • Google Drive：「ストリーミング」モードに切り替えられます
  • メインの同期フォルダ（/Dropbox、/Google Drive）は削除しないでください。クラウド上のファイルも削除されます
2.9 iOS／iPadOSのバックアップ（デバイスごとに通常5～50GB）

パス： ~/Library/Application Support/MobileSync/Backup 安全性：要注意 -- 唯一のコピーである可能性があります。

du -sh ~/Library/Application\ Support/MobileSync/Backup 2>/dev/null
ls -la ~/Library/Application\ Support/MobileSync/Backup/ 2>/dev/null
  • Finderで管理します：デバイスを接続 > 一般 > バックアップを管理
  • ユーザーがiCloudバックアップを使用している場合、ローカルバックアップは重複している可能性があります
  • 削除する前に必ず確認してください
2.10 アプリケーションのキャッシュ（合計で通常2～20GB）

パス： ~/Library/Caches 安全性：安全 -- 自動的に再構築されます。

重要：キャッシュを削除する前に、アプリが起動中かどうかを確認してください。

du -sh ~/Library/Caches 2>/dev/null
du -sh ~/Library/Caches/*/ 2>/dev/null | sort -rh | head -20

容量の大きい一般的なキャッシュ：Spotify、Chrome（Google）、Safari、Apple Music、アプリのアップデートキャッシュ（*.ShipIt）

  • キャッシュを削除する前に、アプリを終了してください
2.11 大容量のアプリケーション（1つあたり通常1～15GB）

安全性：安全 -- 再ダウンロードできます。

find /Applications -maxdepth 2 -name "*.app" -exec du -sh {} \; 2>/dev/null | sort -rh | head -20

容量を大きく消費する一般的なアプリ：

  • GarageBand（1～3GB、サウンドライブラリは最大15GB）-- ユーザーが音楽を作成しない場合は削除します
  • Xcode（12～35GB）-- 開発者のみ必要です
  • iMovie（2～3GB）
  • Logic Pro／Final Cut Pro（1～6GB、ライブラリを含む）
  • Microsoft Office（合計4～8GB）
  • Adobe Creative Cloud（1つあたり2～10GB）
2.12 古いmacOSインストーラー（1つあたり通常5～13GB）

安全性：安全

find /Applications -maxdepth 1 -name "Install macOS*" -exec du -sh {} \; 2>/dev/null
  • macOSのアップグレード後に残ったファイルです。アップグレードが正常に完了した後は安全に削除できます
2.13 アンインストールしたアプリの残存ファイル（合計で通常0.5～5GB）

パス： ~/Library/Application Support、~/Library/Containers 安全性：安全 -- 削除済みアプリの孤立ファイルです。

ls ~/Library/Application\ Support/ 2>/dev/null
ls ~/Library/Containers/ 2>/dev/null
  • /Applicationsにあるインストール済みアプリと照合します
  • アプリがインストールされていない場合は安全に削除できます
2.14 画面収録とデスクトップ上の不要なファイル（通常0.5～10GB）

安全性：先に確認

du -sh ~/Desktop 2>/dev/null
find ~/Desktop ~/Documents ~/Downloads \( -name "Screen Recording*" -o -name "Screenshot*" -o -name "*.mov" -o -name "*.mp4" \) -size +100M -exec ls -lh {} \; 2>/dev/null
  • 画面収録は1分あたり100MB以上になることがあります
  • 古いファイルを確認して削除するようユーザーに提案してください
2.15 システムデータ（通常 5～30GB）

安全性：注意

Time Machine のローカルスナップショット：

tmutil listlocalsnapshots / 2>/dev/null
  • 削減：sudo tmutil thinlocalsnapshots / 99999999999 1
  • 外付けの Time Machine バックアップがある場合は、安全に削除できます

システム／ユーザーログ：

du -sh ~/Library/Logs /var/log 2>/dev/null
  • ユーザーログ（~/Library/Logs/*）：安全に削除できます
  • クラッシュレポート（~/Library/Logs/DiagnosticReports）：安全に削除できます

スリープイメージとスワップ：

  • macOS によって管理されます。手動で削除しないでください。

注意： FileVault が有効な Mac では、クリーンアップ後にディスク容量の数値が一致しないように見える場合があります。これは正常です。APFS による空き領域の再利用には時間がかかります。

2.16 フォント（通常 0.1～2GB）

安全性：注意

du -sh ~/Library/Fonts /Library/Fonts 2>/dev/null
  • ~/Library/Fonts 内のユーザーフォント：安全に削除できます
  • /Library/Fonts 内のシステムフォント：削除しないでください
  • Font Book.app で管理します
2.17 プリンタードライバー（通常 0.5～3GB）

安全性：安全 -- プリンターを再接続すると再ダウンロードされます。

du -sh /Library/Printers 2>/dev/null
  • 使用しなくなったプリンターの古いドライバー
  • クリーンアップ：sudo rm -rf /Library/Printers/*
2.18 開発者ツール（存在しない場合はスキップ）

確認条件： 開発者ツールが検出された場合にのみ、このセクションを確認します。

xcode-select -p &>/dev/null && echo "Dev tools found" || echo "No dev tools"

Xcode とシミュレーター：

if xcode-select -p &>/dev/null; then
    du -sh ~/Library/Developer/CoreSimulator ~/Library/Developer/Xcode/DerivedData ~/Library/Developer/Xcode/Archives ~/Library/Developer/Xcode/iOS\ DeviceSupport 2>/dev/null | sort -rh
fi
  • DerivedData：安全に削除できます（Xcode が起動していないことを確認：pgrep -x Xcode）
  • 古いシミュレーター：xcrun simctl delete unavailable
  • 古いランタイム：xcrun simctl runtime delete <id>

パッケージマネージャーのキャッシュ：

command -v brew &>/dev/null && du -sh "$(brew --cache)" 2>/dev/null
command -v npm &>/dev/null && du -sh ~/.npm 2>/dev/null
command -v pnpm &>/dev/null && du -sh ~/Library/pnpm 2>/dev/null
du -sh ~/Library/Caches/pip ~/Library/Caches/go-build ~/Library/Caches/CocoaPods ~/.cargo ~/.rustup ~/.gradle ~/.m2/repository ~/Library/Caches/Yarn 2>/dev/null | sort -rh

クリーンアップ（インストール済みのツールに対してのみ実行）：

command -v npm &>/dev/null && npm cache clean --force
command -v brew &>/dev/null && brew cleanup --prune=all && brew autoremove
command -v pip3 &>/dev/null && pip3 cache purge
command -v pnpm &>/dev/null && pnpm store prune
command -v go &>/dev/null && go clean -cache
command -v yarn &>/dev/null && yarn cache clean
command -v cargo &>/dev/null && rm -rf ~/.cargo/registry/cache ~/.cargo/registry/src

Docker：

if command -v docker &>/dev/null && docker info &>/dev/null 2>&1; then
    docker system df
    # Show stopped containers before pruning:
    docker ps -a --filter "status=exited" --format "table {{.Names}}\t{{.Size}}" 2>/dev/null
fi
  • docker system prune -f（停止中のコンテナー、未使用のイメージ／ネットワークを削除します）
  • docker builder prune -f（ビルドキャッシュを削除します）

各所に散在するプロジェクトの生成物：

find ~ -maxdepth 4 -name "node_modules" -type d -prune -exec du -sh {} + 2>/dev/null | sort -rh | head -10
find ~ -maxdepth 4 -type d \( -name ".venv" -o -name "venv" \) -exec du -sh {} + 2>/dev/null | sort -rh | head -10
  • node_modules：常に安全に削除できます（npm install で再作成できます）
  • venv：安全に削除できます（pip install -r requirements.txt で再作成できます）

ステップ 3：提示して確認する

番号付きの概要表を提示します：

| # | Target                   | Size  | Safety       |
|---|--------------------------|-------|--------------|
| 1 | Trash                    | 8.2G  | Safe         |
| 2 | Downloads (old DMGs)     | 3.1G  | Review first |
| 3 | Mail Downloads cache     | 1.5G  | Safe         |
| 4 | Browser caches           | 2.3G  | Safe         |
| 5 | Application caches       | 4.1G  | Safe         |
| 6 | GarageBand (not used)    | 3.0G  | Safe         |
| 7 | Old macOS installer      | 12.2G | Safe         |
| 8 | iOS backup (old phone)   | 15G   | Confirm      |
|   | **Total reclaimable**    | ~49G  |              |

どの項目をクリーンアップするか、ユーザーに尋ねます（例：「1, 3, 4, 5, 7」または「安全な項目をすべて」）。

対象モードでは、累計の列を表示します：

| # | Target              | Size | Cumulative | Safety |
|---|---------------------|------|------------|--------|
| 1 | Old macOS installer | 12G  | 12G        | Safe   |
| 2 | Trash               | 8G   | 20G        | Safe   |
| 3 | iOS backup          | 15G  | 35G        | Confirm|
"Cleaning items 1-2 would free 20GB, meeting your 15GB goal."

ステップ 4：クリーンアップして報告する

  1. キャッシュを削除するアプリを閉じます（ユーザーに警告します）
  2. 確認済みの項目のみクリーンアップを実行します
  3. 実行前後を表示します：
df -h /
  1. 回復した容量の合計を報告します

ヒント

  • macOS に内蔵されているツールを案内します：Apple メニュー > システム設定 > 一般 > ストレージ
  • 定期的なクリーンアップには、「ゴミ箱を自動的に空にする」を有効にするよう提案します（Finder > 設定 > 詳細）
  • iCloud ユーザーは、「Mac ストレージを最適化」によって多くの空き容量を自動的に確保できます

コメント

Markdown 対応