$ 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

``sh


Use with npx (recommended)


npx xcodebuild
`

Examples

`sh


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

`sh


Install dependencies

bun install

Build the wrapper

bun run build

Run tests

bun run test
``