xcode-build-analyzer

# Xcode Build Analyzer

Analyze Xcode build performance, warnings, errors, and history by reading DerivedData build logs on macOS.

## Requirements

- **macOS only** — reads from `~/Library/Developer/Xcode/DerivedData/`
- **Xcode** must be installed and have built at least one project
- **plutil**, **gunzip**, **sqlite3** (all pre-installed on macOS)
- Full Disk Access may be required depending on the process running queries

## Key paths

```
DERIVED_DATA=~/Library/Developer/Xcode/DerivedData
```

Each project has a folder named `<ProjectName>-<hash>` containing:
- `info.plist` — project workspace path and last accessed date
- `Logs/Build/LogStoreManifest.plist` — structured index of all builds (timing, status, warnings, errors)
- `Logs/Build/*.xcactivitylog` — gzip-compressed SLF build logs with per-step timing and full compiler output

> **Important:** All queries are read-only. Never modify DerivedData contents.

## List all projects in DerivedData

```bash
for dir in ~/Library/Developer/Xcode/DerivedData/*-*; do
  [ -d "$dir" ] || continue
  NAME="$(basename "$dir" | sed 's/-[a-z]*$//')"
  WORKSPACE="$(plutil -extract WorkspacePath raw "$dir/info.plist" 2>/dev/null || echo "unknown")"
  LAST_ACCESS="$(plutil -extract LastAccessedDate raw "$dir/info.plist" 2>/dev/null || echo "unknown")"
  echo "$NAME | $WORKSPACE | Last accessed: $LAST_ACCESS"
done
```

## Build history for a project

Parse the `LogStoreManifest.plist` for structured build data. This is the most reliable source — it contains timing, error/warning counts, and scheme info for every build without needing to decompress logs.

```bash
# Replace PROJECT_DIR with the project's DerivedData folder
# To find it: ls ~/Library/Developer/Xcode/DerivedData/ | grep -i "ProjectName"
PROJECT_DIR="$(ls -d ~/Library/Developer/Xcode/DerivedData/PROJECT_NAME-* 2>/dev/null | head -1)"
MANIFEST="$PROJECT_DIR/Logs/Build/LogStoreManifest.plist"

plutil -convert json -o - "$MANIFEST" 2>/dev/null | python3 -c "
import js...