Xcode disk usage grows fast, especially with agentic development workflows using multiple Git worktrees. The author created an open-source Xcode Disk Cleanup Agent Skill that audits Derived Data, Simulators, archives, DeviceSupport, and caches before proposing any deletions. The skill uses a deterministic Python script to produce structured JSON output, keeping token usage low. It integrates with tools like Cursor, Claude Code, and Codex via the npx skills command. Cleanup is always approval-gated — nothing is deleted without explicit user confirmation, and irreversible operations like Simulator removal require a second confirmation. Archives are handled conservatively: distributed archives and the newest undistributed archive are preserved. The skill can also be triggered automatically when an agent detects low storage during a build or download failure.
