$ npx xcodebuild

xcodebuild that doesn't blow up your context window.

A modern CLI wrapper for Apple's xcodebuild that formats verbose build output into clean, colored, human-readable messages using my custom xcpretty library.

Features

• ✨ Pretty output: Clean, colored formatting for build operations
• 🎯 Smart filtering: Suppresses noise from node_modules and Pods
• 📊 Build summary: Shows error and warning counts
• 📝 Log files: Automatic logging to .xcodebuild/xcodebuild.log
• 🚀 Zero config: Works as a drop-in replacement for xcodebuild
• ⚡ Fast: Informational commands bypass formatting for instant results

Usage

# Use with npx (recommended)
npx xcodebuild <args>

Examples

# Build a project (formatted output)
npx xcodebuild -project MyApp.xcodeproj -scheme MyApp -configuration Debug build

# Show version (raw output)
npx xcodebuild -version

# List SDKs (raw output)
npx xcodebuild -showsdks

Development

# Install dependencies
bun install

# Build the wrapper
bun run build

# Run tests
bun run test