xcode-cleanup

Audit Xcode disk usage and identify reclaimable build caches, simulator runtimes, and archives.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill xcode-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xcode-cleanup
Source: https://github.com/Brandondaymdr/Claude-Skills/tree/main/xcode-cleanup
Command: npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill xcode-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the issue of silent disk space exhaustion caused by Xcode's accumulation of build caches, simulator runtimes, and legacy archives.

Core Features & Use Cases

  • Comprehensive Audit: Scans DerivedData, simulators, archives, and caches to identify reclaimable space.
  • Safety-First Cleanup: Provides a clear distinction between safe-to-delete files and items requiring manual review, ensuring source code and preferences remain untouched.
  • Use Case: When your Mac reports low disk space, use this skill to safely identify and remove gigabytes of stale build artifacts and unused simulator runtimes without breaking your development environment.

Quick Start

Ask the assistant to run the xcode-cleanup skill to audit your current Xcode storage usage and identify reclaimable disk space.

Frequently Asked Questions about xcode-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely reclaim disk space from Xcode build caches and simulator runtimes?

To reclaim disk space from Xcode, audit system paths for DerivedData, simulator runtimes, and archives. This process distinguishes between safe-to-delete files and items requiring manual review, ensuring source code remains untouched while removing gigabytes of stale build artifacts.

Why does Xcode take up so much disk space on my Mac?

Xcode consumes disk space through the silent accumulation of build caches, simulator runtimes, and legacy archives. Scanning these specific directories identifies reclaimable space, targeting development environments experiencing storage constraints caused by stale data.

What is the best way to clean up Xcode DerivedData without breaking my development environment?

The best way to clean up Xcode DerivedData is using an audit script that provides a clear distinction between safe-to-delete files and items requiring manual review. This safety-first approach ensures preferences and source code remain untouched while removing stale build artifacts.

Can I use a shell script to audit and manage Xcode storage usage?

Yes, you can use shell scripts to audit Xcode storage usage by scanning system paths for build caches and simulator runtimes. This requires shell access to execute audit scripts and perform file system operations on Xcode-specific directories.

When should I manually review files before deleting Xcode archives and caches?

You should manually review files when the audit identifies data that is not clearly safe to delete. The safety-first cleanup approach provides a clear distinction between safe-to-delete files and items requiring manual review to prevent breaking your development environment.