XZap

The Ultimate Xcode Cleaner — Reclaim disk space by cleaning Xcode simulators, runtimes, and caches in a TUI.

---

Features

• Interactive TUI — Beautiful terminal UI with tabs for Simulators, Caches, and Runtimes
• Clean DerivedData, Archives, ModuleCache, Xcode Cache, iOS DeviceSupport, DocumentationCache, SwiftPM, CocoaPods, and Carthage caches
• List simulators with storage usage, grouped by status
• Orphaned simulator detection — Identifies simulators whose runtime was deleted
• Highlight critical simulators (above 3GB or your threshold)
• List and remove runtimes
• Interactive cleanup of large simulators
• Dry-run, Force Clean, Summary-only modes
• Save reports to file with --output
• Built for macOS – supports Intel & Apple Silicon
• Beautiful interface with Catppuccin theme, colors, and spinners

---

Installation

git clone https://github.com/ApptitudeLabs/xzap.git
cd xzap
make build-mac
./bin/xzap_darwin_arm64              # Launch interactive TUI
./bin/xzap_darwin_arm64 --cli help   # Use CLI mode

---

Usage

Interactive TUI (Default)

Simply run xzap to launch the interactive terminal UI:

xzap

Keyboard shortcuts:

Key	Action
Tab	Switch to next view
Shift+Tab	Switch to previous view
1 / 2 / 3	Jump to Simulators / Caches / Runtimes
j / k or ↑ / ↓	Navigate list
Space	Toggle selection
a	Select all critical items
A	Select all items
d	Clear selection
Enter	Delete selected items
r	Refresh list
q	Quit

Simulator grouping: Simulators are organized into three sections:

• Orphaned — Simulators whose runtime is no longer available (safe to delete)
• Critical — Simulators using more than 3GB
• Normal — All other simulators

---

CLI Usage Examples

Use the --cli flag to access the traditional command-line interface:

# Clean Xcode caches
xzap --cli clean                              # Clean all Xcode caches (see paths below)
xzap --cli clean --dry-run                    # Preview what would be deleted

# List and manage simulators
xzap --cli list sims                          # List simulators with storage usage
xzap --cli list sims --threshold 2            # Only show simulators larger than 2GB
xzap --cli list sims --summary-only           # Only print total space and counts
xzap --cli list sims --output report.txt      # Save full report to file
xzap --cli list sims --clean                  # Interactively delete large sims (>3GB)
xzap --cli list sims --clean --dry-run        # Simulate what would be cleaned
xzap --cli list sims --clean --force-clean    # Delete without confirmation
xzap --cli cleansims                          # Delete all sims over 2GB (with confirmation)
xzap --cli cleansims --dry-run                # Preview what would be deleted
xzap --cli cleansims --force                  # Delete without confirmation

# Manage runtimes
xzap --cli list runtimes                      # List installed Xcode runtimes
xzap --cli remove runtime "iOS 17.5"          # Remove a specific runtime
xzap --cli remove runtime "iOS 17.5" --force  # Force remove runtime without asking

What clean removes

Path	Description
~/Library/Developer/Xcode/DerivedData	Build artifacts
~/Library/Developer/Xcode/Archives	App archives
~/Library/Developer/Xcode/ModuleCache.noindex	Clang module cache
~/Library/Caches/com.apple.dt.Xcode	Xcode app cache
~/Library/Developer/Xcode/iOS DeviceSupport	Per-device debug symbols
~/Library/Developer/Xcode/DocumentationCache	Downloaded doc sets
~/Library/Developer/Xcode/Products	Build products
~/Library/Caches/org.swift.swiftpm	SwiftPM package cache
~/.swiftpm	SwiftPM global data
~/Library/Caches/CocoaPods	CocoaPods cache
~/.cocoapods/repos	CocoaPods spec repos
~/Library/Caches/org.carthage.CarthageKit	Carthage build cache

Each path reports the space freed after deletion and is skipped gracefully if it doesn't exist.

---

Screenshot

Interactive TUI with tabbed navigation, Catppuccin theme, and real-time updates.

---

Roadmap

• Homebrew tap install (brew install xzap)
• Export JSON or Markdown reports

---

Disclaimer

XZap permanently deletes files and directories from your system. Always use --dry-run first to preview what will be removed. The authors are not responsible for any data loss resulting from use of this tool. Use at your own risk.

---

License

MIT © Apptitude Labs