my-disk-cleanup

name

my-disk-cleanup

description

Clean up disk space by removing caches and unnecessary files on macOS and Ubuntu. Targets: Docker (images, build cache, volumes), package managers (Homebrew, apt, pip, npm, yarn), and temporary files (__pycache__, .mypy_cache, Xcode DerivedData). Reports disk usage before/after with freed space summary. Use when the user asks to free disk space, clean caches, or mentions "ディスク整理", "キャッシュ削除", "disk cleanup", "free space", "clean docker", "clean caches". Do NOT use for file organization, deduplication, or finding large files.

Disk Cleanup

Cross-platform disk cleanup for macOS and Ubuntu. Cleans caches category-by-category with user confirmation, showing disk usage before and after.

Workflow

1. Survey disk usage (dry run)

Run the cleanup script in dry-run mode to show current cache sizes without deleting anything:

bash ${CLAUDE_SKILL_DIR:?}/scripts/cleanup.sh --dry-run

Present the results to the user organized by category. Highlight the largest categories.

2. Confirm categories with user

Ask which categories to clean. Available categories:

• docker — Docker images, build cache, dangling containers (volumes only with --include-volumes)
• brew — Homebrew download cache (macOS)
• apt — APT package cache (Ubuntu)
• pip — pip download cache
• npm — npm cache
• yarn — yarn cache
• tmp — Temporary files: __pycache__, .mypy_cache, Xcode DerivedData (macOS)

Default: all detected categories. User can select a subset.

3. Execute cleanup

Run the script for selected categories:

# All categories
bash ${CLAUDE_SKILL_DIR:?}/scripts/cleanup.sh

# Specific categories (comma-separated)
bash ${CLAUDE_SKILL_DIR:?}/scripts/cleanup.sh --category docker,brew,pip

# Also prune unused Docker volumes (opt-in; may delete DB data)
bash ${CLAUDE_SKILL_DIR:?}/scripts/cleanup.sh --category docker --include-volumes

--include-volumes deletes unused named Docker volumes (databases, persistent app data). NEVER pass it unless the user has explicitly confirmed volume deletion in this session.

4. Report results

The script outputs a before/after comparison. Summarize:

• Disk available before and after
• Total space freed
• Per-category breakdown of what was cleaned

Notes

• Docker cleanup uses docker system prune -af and docker builder prune -af — this removes ALL unused images, containers, and build cache. Warn the user before running.
• Unused Docker volumes are pruned only when --include-volumes is passed. Volumes can hold database and application data, so ask the user for explicit confirmation before using this flag.
• sudo is required for apt-get clean on Ubuntu.
• The tmp category runs find with -maxdepth 4 from $HOME to avoid excessive traversal.
• ~/Library/Caches (macOS) is reported but NOT deleted automatically — only specific subdirectories (Xcode DerivedData, pycache, .mypy_cache) are removed.