free-disk-space

ディスクの空き容量を増やす（macOS）

ディスクを調査し、安全に再生成できるものを削除します。そうでないものに手を付ける前に、必ず確認します。

基本ルール

• rm -rf の代わりに、（CLI が利用できる場合は）trash を使います。削除するものはゴミ箱に移動し、最後にユーザーにゴミ箱を空にするよう依頼します。
• ディレクトリを削除するより、各ツールの専用クリーンアップコマンドを優先します（go clean -cache、brew cleanup --prune=all、pnpm store prune、npm cache clean --force、cargo clean）。
• df -h /System/Volumes/Data で容量を確認します（単なる df / ではありません）。
• GUI アプリのデータは削除しないでください。 ~/Library/Caches/<App> と ~/Library/Application Support/<App> には、ログイン情報、Cookie、履歴が保存されていることがよくあります。ユーザーが特定のアプリを指定し、リスクを了承した場合を除き、そのまま残してください。ビルド関連のクリーンアップ、パッケージマネージャーによる整理、古い worktree の削除、外部ドライブへの退避を優先します。

作業手順

1. 状況を確認する

df -h /System/Volumes/Data; ls /Volumes を実行します。空き容量と、外部ドライブがマウントされているかを確認します。

2. 使用状況を調査する

~ 全体ではなく、対象を絞って du -sh ... | sort -hr を実行します。よく容量を使う項目は次のとおりです。

• ビルド成果物：target/（各 worktree のものも含む）、node_modules/、Xcode DerivedData
• パッケージマネージャーのキャッシュ：go-build、Homebrew、pnpm/npm/pip のストア。CLI でクリーンアップします
• 大きなメディアファイル：CapCut、Screen Studio、Movies、Downloads
• アプリのキャッシュ／Application Support の容量は報告するだけにし、自動削除はしません

3. 確認なしで安全な項目を削除する

ビルド成果物と、パッケージマネージャー／言語ツールのキャッシュのみを対象にします。それ以外（アプリデータ、メディア、モデルの重み、ツールチェーン）は、容量をまとめてユーザーに確認するか、別の場所への退避を提案します。

4. Git worktree を監査する

各 worktree について、変更があるか、固有のコミットや未 push のコミットがあるかを確認します。変更がなく、すべてマージ済みまたは push 済みであれば、git worktree remove と git branch -d を実行します（-D は絶対に使いません）。変更があるものや、ブランチが先行しているものは残して報告します。

5. 残しておく項目を別の場所へ退避する

rsync -a でコピーし、容量を確認してから、元の項目をゴミ箱に移動し、元のパスにシンボリックリンクを作成します。~/Movies のような特殊なディレクトリ全体ではなく、個別のフォルダーにシンボリックリンクを作成します。アプリの使用時にはドライブをマウントする必要があることを伝えます。

6. 完了時に報告する

すぐに空き容量が増えた分、ゴミ箱に移動したもの、残したものを報告します。ユーザーにゴミ箱を空にして、df を再確認するよう依頼します。