xcode-cleanup

A simple CLI tool to automatically clean Xcode derived data with scheduled cleanup support.

Installation

npm install -g xcode-cleanup

Or use directly with npx:

npx xcode-cleanup <command>

Commands

init

Set up automated scheduled cleanup of Xcode derived data. This will guide you through an interactive prompt to choose:

• Frequency: Daily, Weekly, or Monthly
• Day: Which day (for weekly/monthly schedules)
• Hour: What time (24-hour format)

After selecting your preferences, you can choose to:

• Add the command to crontab manually
• Create a launchd plist file (macOS recommended)
• Skip automated setup

xcode-cleanup init

remove

Immediately remove all Xcode derived data from ~/Library/Developer/Xcode/DerivedData.

xcode-cleanup remove

How it works

The init command creates a schedule configuration saved to ~/.xcode-cleanup-schedule.json. You can then set up automation using either:

1. Crontab: Traditional Unix scheduling
2. Launchd (macOS): Native macOS scheduling with plist files

Examples

# Set up daily cleanup at 2 AM
xcode-cleanup init

# Clean derived data immediately
xcode-cleanup remove

Development

# Install dependencies
npm install

# Run locally
node src/index.js --help