開発マシンのメンテナンスは、やるべきだと分かっていながら後回しにしがちな作業の一つです。

Homebrewのアップデート、Dockerの肥大化したキャッシュ、積み上がったDerivedData——個別には些細でも、放置すれば確実にディスクとパフォーマンスを蝕みます。

本記事では、私が普段使用しているシェルスクリプトを紹介します。

設計方針

メンテナンススクリプトには独特の要件があります。
一部のコマンドが失敗しても、残りは実行を続けてほしい。set -e を使わない理由はここにあります。

set -uo pipefail

-u で未定義変数の参照を防ぎ、pipefail でパイプ中の失敗を検知します。
-e を外すことで、例えば brew doctor が警告を返しても後続の処理は止まりません。

構成

スクリプトは5つのセクションから成ります。

Homebrewの更新とクリーンアップ

brew update && brew upgrade && brew upgrade --cask --greedy
brew cleanup && brew autoremove
brew doctor

--cask --greedy は、自動更新機能を持つアプリ（Chrome、Firefox等）も含めて強制的にアップグレードします。
brew cleanup と brew autoremove で古いバージョンと不要な依存を除去し、brew doctor で環境の整合性を確認します。

Mac App Store

mas upgrade

mas を使い、App Store経由でインストールしたアプリもCLIから更新します。

Xcode関連

xcrun simctl delete unavailable

使われなくなったシミュレータランタイムを削除します。
これだけで数十GBの空きが生まれることもあります。

DerivedDataについては、Xcodeの起動状態を確認してから削除します。

if ! pgrep -q Xcode; then
  rm -rf ~/Library/Developer/Xcode/DerivedData/*
fi

ビルドキャッシュを消すだけなので、次回ビルド時に再生成されます。
起動中のXcodeを壊す心配を避けるためのガードです。

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

npm と pnpm のキャッシュを整理します。
いずれも command -v で存在確認してから実行するため、インストールしていない環境でもエラーにはなりません。

npm cache verify    # 整合性チェック。全削除はしない
pnpm store prune    # 未参照パッケージの削除

npm cache clean --force ではなく verify を選んでいるのは、壊れたエントリだけを除去し、有効なキャッシュは維持するためです。

Docker クリーンアップ

if command -v docker &>/dev/null && docker info &>/dev/null; then
  docker system prune -f --volumes --filter "until=168h"
  docker builder prune -f --filter "until=168h"
fi

docker info でデーモンの起動確認を行い、停止中なら何もしません。
--filter "until=168h" により、1週間以内に使用したリソースは保持されます。
直近の作業を壊さない安全策です。

キャッシュ容量の可視化

最後に ~/Library/Caches の上位10ディレクトリを表示します。

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

自動削除はしません。
アプリケーションキャッシュの削除判断は人間に委ねるべきです。

使い方

適当な場所に保存して実行権限を付与します。

chmod +x ~/scripts/maintenance.sh

手動で定期実行してもいいですし、launchd でスケジュールしても構いません。
ただし、Homebrewやmasは対話的な認証を求めることがあるため、完全な無人実行には向かない点に留意してください。

スクリプト全文

#!/bin/bash

# -------------------------------------------
# エラーハンドリング方針:
#   メンテナンススクリプトの性質上、一部失敗しても続行したいため
#   set -e は使わず、重要なコマンドのみ個別にハンドリングする。
#   未定義変数の参照とパイプ途中の失敗は検知する。
# -------------------------------------------
set -uo pipefail

# ===========================================
# Homebrewパッケージ更新とクリーンアップ
# ===========================================
brew update && brew upgrade && brew upgrade --cask --greedy
brew cleanup && brew autoremove
brew doctor

# ===========================================
# Mac App Storeアプリのアップデート
# ===========================================
mas upgrade

# ===========================================
# Xcode関連の不要ファイル削除
# ===========================================
xcrun simctl delete unavailable

# Xcodeが起動中でなければDerivedDataを削除
if ! pgrep -q Xcode; then
  rm -rf ~/Library/Developer/Xcode/DerivedData/*
else
  echo "⚠ Xcodeが起動中のためDerivedDataの削除をスキップしました"
fi

# ===========================================
# パッケージマネージャのキャッシュ/ストア整理
# ===========================================
# npm キャッシュの検証（整合性チェックのみ、全削除はしない）
if command -v npm &>/dev/null; then
  echo "--- npm cache verify ---"
  npm cache verify
fi

# pnpm ストアの最適化（未参照の依存パッケージを削除）
if command -v pnpm &>/dev/null; then
  echo "--- pnpm store prune ---"
  pnpm store prune
fi

# ===========================================
# Docker クリーンアップ
# ===========================================
if command -v docker &>/dev/null && docker info &>/dev/null 2>&1; then
  echo "--- Docker system prune ---"
  # 1週間以上前の未使用リソース + 未使用ボリュームを削除
  docker system prune -f --volumes --filter "until=168h"

  echo "--- Docker builder prune ---"
  docker builder prune -f --filter "until=168h"
fi

# ===========================================
# キャッシュ容量の確認（削除は手動判断）
# ===========================================
echo ""
echo "=== ~/Library/Caches 容量 Top 10 ==="
du -sh ~/Library/Caches/* 2>/dev/null | sort -rh | head -n 10
echo ""
echo "※ 不要なキャッシュがあれば手動で削除してください"
echo "  例: rm -rf ~/Library/Caches/<アプリ名>"

まとめ

このスクリプトが行うのは「安全に削除できるものだけを削除し、判断が必要なものは報告する」ことです。
定型作業を自動化するだけでも、ディスク容量とビルド環境の健全性は改善します。