# Check Xcode
xcodebuild -version || echo "ERROR: Xcode not found - install from App Store"

# Check Node.js (required for XcodeBuildMCP)
node --version || echo "ERROR: Node.js not found - install from nodejs.org or 'brew install node'"

# Check npm
npm --version || echo "ERROR: npm not found - comes with Node.js"

# Check Git
git --version || echo "ERROR: Git not found"

# Check if we're in a git repository
git status || echo "WARNING: Not a git repository - some features won't work"

# Claude Code always runs from the project root
PROJECT_ROOT=$(pwd)
echo "Project root: $PROJECT_ROOT"

# Claude Code MCP configuration location
MCP_CONFIG_PATH="$HOME/Library/Application Support/Claude/claude_desktop_config.json"
if [ -f "$MCP_CONFIG_PATH" ]; then
    echo "Claude Desktop config found"
else
    echo "NOTE: Will need to configure MCP manually in Claude Code settings"
fi

# Find Xcode project files
find . -name "*.xcodeproj" -o -name "*.xcworkspace" | head -5

# Detect Swift version
if [ -f "Package.swift" ]; then
    grep "swift-tools-version" Package.swift
fi

# Check for project configuration
if ls *.xcodeproj >/dev/null 2>&1; then
    PROJECT_FILE=$(ls *.xcodeproj | head -1)
    echo "Found project: $PROJECT_FILE"
    
    # Extract key information
    xcodebuild -list -project "$PROJECT_FILE" 2>/dev/null || true
fi

# Detect minimum iOS version from Info.plist or project settings
find . -name "Info.plist" -exec grep -A1 "MinimumOSVersion" {} \; 2>/dev/null || true

# Check for build configuration files
ls -la | grep -E "project.yml|project.yaml|Tuist|Package.swift"

# List available schemes
if [ -n "$PROJECT_FILE" ]; then
    xcodebuild -list -project "$PROJECT_FILE" | grep -A20 "Schemes:" || true
fi

# Check for dependency managers
[ -f "Podfile" ] && echo "Found CocoaPods"
[ -f "Cartfile" ] && echo "Found Carthage"
[ -f "Package.swift" ] && echo "Found Swift Package Manager"

# Find all Swift packages
find . -name "Package.swift" -not -path "*/.*" | while read pkg; do
    echo "Package found: $pkg"
    dirname "$pkg"
done

# Find test targets
find . -name "*Tests" -type d -not -path "*/.*" | head -10

# Detect test framework
grep -r "@testable import\|import XCTest\|import Testing" --include="*.swift" . | head -5 || true

# Find UI test targets
find . -name "*UITests" -type d -not -path "*/.*"

# Find app extensions
find . -name "*.appex" -o -name "*Widget*" -o -name "*Extension*" -type d | grep -v ".build" | head -10

# Check for linting/formatting tools
[ -f ".swiftlint.yml" ] && echo "SwiftLint configured"
[ -f ".swiftformat" ] && echo "SwiftFormat configured"

# Check for existing build scripts
[ -f "Makefile" ] && echo "Makefile found"
[ -f "Rakefile" ] && echo "Rakefile found"
[ -f "build.sh" ] && echo "Build script found"
ls scripts/*.sh 2>/dev/null | head -5

# Create the Claude configuration directory structure
mkdir -p .claude/commands
mkdir -p .claude/hooks  
mkdir -p .claude/scripts
mkdir -p .claude/imports

# Confirm structure
tree .claude || ls -la .claude/

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

**⚠️ IMPORTANT**: Keep this documentation updated! Run `/update-docs` after significant changes.
**Last Updated**: [CURRENT_DATE]

## 📋 Documentation Maintenance

- **When to Update**: After adding features, changing architecture, or modifying workflows
- **Update Command**: Use `/update-docs` to refresh all CLAUDE.md files
- **Optimize Setup**: Use `/claude-optimize` to analyze and improve configuration
- **Review Schedule**: Check documentation accuracy weekly

## Quick Reference

**Project**: [PROJECT_NAME - from analysis]
**Language**: Swift [VERSION - from analysis]
**Platform**: [iOS/macOS/etc - from analysis]
**Architecture**: [Detected pattern - SwiftUI/UIKit/etc]
**Key Command**: Build and test via MCP tools

## 🔧 XcodeBuildMCP Integration

**IMPORTANT**: This project uses XcodeBuildMCP for all Xcode operations. The MCP server is automatically available in Claude Code.

### Why XcodeBuildMCP?
- Provides intelligent, context-aware Xcode operations
- Automatically handles simulator management
- Simplifies device deployment
- Offers better error handling than raw xcodebuild

### Common MCP Operations
```swift
// Building
mcp__xcodebuildmcp__build_sim_name_proj      // Build for simulator
mcp__xcodebuildmcp__build_dev_proj           // Build for device

// Testing
mcp__xcodebuildmcp__test_sim_name_proj       // Test on simulator
mcp__xcodebuildmcp__swift_package_test       // Test Swift packages

// Running
mcp__xcodebuildmcp__build_run_sim_name_proj  // Build and run on simulator
mcp__xcodebuildmcp__launch_app_sim           // Launch existing app

// Utilities
mcp__xcodebuildmcp__clean_proj               // Clean build artifacts
mcp__xcodebuildmcp__list_sims                // List available simulators
mcp__xcodebuildmcp__screenshot               // Take simulator screenshot

### 2.3 Create Context Detection System

Create `.claude/scripts/detect-context.sh`. This script will be customized based on your project structure:

```bash
#!/bin/bash
# Context detection for Claude Code XcodeBuildMCP integration
# This script analyzes the current context and sets appropriate defaults

# Get absolute project root (Claude Code always runs from project root)
PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
CURRENT_DIR=$(pwd)

# Function to find project file
find_project_file() {
    # Look for xcworkspace first (takes precedence)
    local workspace=$(find "$PROJECT_ROOT" -name "*.xcworkspace" -maxdepth 2 | grep -v xcodeproj | head -1)
    if [ -n "$workspace" ]; then
        echo "$workspace"
        return
    fi
    
    # Fall back to xcodeproj
    local project=$(find "$PROJECT_ROOT" -name "*.xcodeproj" -maxdepth 2 | head -1)
    if [ -n "$project" ]; then
        echo "$project"
        return
    fi
}

# Function to detect default scheme
detect_default_scheme() {
    local project_file="$1"
    if [ -n "$project_file" ]; then
        # Try to extract the main scheme
        xcodebuild -list -project "$project_file" 2>/dev/null | \
            grep -A10 "Schemes:" | \
            grep -v "Schemes:" | \
            head -1 | \
            xargs
    fi
}

# Function to find newest simulator
find_newest_simulator() {
    xcrun simctl list devices available | \
        grep "iPhone" | \
        grep -v "unavailable" | \
        tail -1 | \
        sed 's/.*(\(.*\)).*/\1/'
}

# Detect project configuration
PROJECT_FILE=$(find_project_file)
DEFAULT_SCHEME=$(detect_default_scheme "$PROJECT_FILE")
DEFAULT_SIMULATOR=$(find_newest_simulator)

# Export for MCP tools
export XCODEBUILDMCP_PROJECT_ROOT="$PROJECT_ROOT"
export XCODEBUILDMCP_DEFAULT_PROJECT="$PROJECT_FILE"
export XCODEBUILDMCP_DEFAULT_SCHEME="${DEFAULT_SCHEME:-YourApp}"
export XCODEBUILDMCP_DEFAULT_SIMULATOR="${DEFAULT_SIMULATOR:-iPhone 15}"

# Detect if we're in a package directory
if [ -f "Package.swift" ]; then
    export XCODEBUILDMCP_CONTEXT="package"
    export XCODEBUILDMCP_PACKAGE_PATH="$CURRENT_DIR"
elif [[ "$CURRENT_DIR" == *"Tests"* ]]; then
    export XCODEBUILDMCP_CONTEXT="tests"
elif [[ "$CURRENT_DIR" == *"UITests"* ]]; then
    export XCODEBUILDMCP_CONTEXT="uitests"
else
    export XCODEBUILDMCP_CONTEXT="app"
fi

# Check for booted simulator
BOOTED_SIM=$(xcrun simctl list devices | grep "Booted" | head -1 | awk -F'[()]' '{print $2}')
if [ -n "$BOOTED_SIM" ]; then
    export XCODEBUILDMCP_BOOTED_SIMULATOR="$BOOTED_SIM"
fi

# Check for connected physical devices
if xcrun devicectl list devices 2>/dev/null | grep -q "iPhone\|iPad"; then
    export XCODEBUILDMCP_HAS_DEVICE="true"
fi

# Output context (useful for debugging)
if [ "${DEBUG_CONTEXT}" = "true" ]; then
    echo "Context Detection Results:"
    echo "  Project: $PROJECT_FILE"
    echo "  Scheme: $DEFAULT_SCHEME"
    echo "  Simulator: $DEFAULT_SIMULATOR"
    echo "  Context: $XCODEBUILDMCP_CONTEXT"
    echo "  Has Device: ${XCODEBUILDMCP_HAS_DEVICE:-false}"
fi

# This should return diagnostic information
mcp__xcodebuildmcp__diagnostic

# List available simulators
mcp__xcodebuildmcp__list_sims

# If these don't work, MCP may need to be enabled in settings

# XcodeBuildMCP Best Practices

## Always Use MCP Tools
Never use raw xcodebuild commands. Always use the appropriate MCP tool:
- Building: `mcp__xcodebuildmcp__build_sim_name_proj`
- Testing: `mcp__xcodebuildmcp__test_sim_name_proj`
- Running: `mcp__xcodebuildmcp__build_run_sim_name_proj`
- Package operations: `mcp__xcodebuildmcp__swift_package_*`

## Context-Aware Tool Selection
The context detection script automatically determines which tools to use based on your current directory.

## Common Patterns
[Document patterns specific to this project]

---
description: Build the project intelligently
---

# Build the project based on context

First, I'll detect what needs to be built based on the current directory and project structure.

Then I'll use the appropriate MCP tool:
- For the main app: `mcp__xcodebuildmcp__build_sim_name_proj`
- For packages: `mcp__xcodebuildmcp__swift_package_build`
- For specific schemes: Build with the detected scheme

The build will use your project's default simulator and configuration.

---
description: Run all relevant tests
---

# Run tests based on context

I'll run the appropriate tests for your current location:
- App tests: `mcp__xcodebuildmcp__test_sim_name_proj`
- Package tests: `mcp__xcodebuildmcp__swift_package_test`
- UI tests if available

Tests will run on the default simulator with proper configuration.

$ARGUMENTS

---
description: Build and run the app
---

# Build and run in simulator

I'll build and launch your app using:
`mcp__xcodebuildmcp__build_run_sim_name_proj`

This will:
1. Build the latest code
2. Install on simulator
3. Launch the app
4. Show you the simulator

$ARGUMENTS

---
description: Run ALL tests (app + packages)
---

# Complete test suite

I'll run your entire test suite:
1. App unit tests
2. Package tests
3. UI tests (if present)

This ensures everything works before committing.

---
description: Run a specific test
---

# Run specific test

Usage: `/test-single TestClassName` or `/test-single TestClassName/testMethod`

I'll find and run just the test you specify using the appropriate MCP tool with filtering.

$ARGUMENTS

---
description: Show connected devices
---

# List physical devices

I'll show all connected iOS devices using:
`mcp__xcodebuildmcp__list_devices`

This will display device names, UUIDs, and connection status.

---
description: Deploy to physical device
---

# Deploy to device

I'll deploy your app to a connected device:
1. List available devices
2. Build for device architecture
3. Install the app
4. Launch on device

Requires a device to be connected via USB or WiFi.

$ARGUMENTS

---
description: Clean build artifacts
---

# Clean build folder

I'll clean all build artifacts using:
`mcp__xcodebuildmcp__clean_proj`

This helps resolve build issues and ensures a fresh build.

---
description: Update all documentation
---

# Update documentation

I'll refresh all CLAUDE.md files:
1. Analyze current project structure
2. Update main CLAUDE.md
3. Update nested documentation
4. Add new discoveries
5. Update timestamps

This keeps your Claude Code setup current.

---
description: Optimize Claude Code setup
---

# Analyze and optimize

I'll review your entire Claude Code configuration:
1. Check for missing commands
2. Verify MCP is working
3. Test all hooks
4. Suggest improvements
5. Find unused features
6. Recommend new tools

This helps you get the most from Claude Code.

---
description: Run SwiftLint
---

# Lint code

Run SwiftLint to check code style and fix issues.

---
description: List available schemes
---

# Show all schemes

Display all available build schemes for this project.

#!/bin/bash
# Welcome message with project context

PROJECT_NAME=$(basename "$(pwd)")
SWIFT_VERSION=$(swift --version 2>/dev/null | head -1 | grep -o '[0-9]\+\.[0-9]\+' | head -1)

echo "🚀 Starting $PROJECT_NAME session" >&2
echo "📱 Swift $SWIFT_VERSION | Xcode $(xcodebuild -version | head -1)" >&2

# Check for common issues
if ! command -v node &> /dev/null; then
    echo "⚠️  Node.js not found - MCP tools may not work" >&2
fi

# Show git status
BRANCH=$(git branch --show-current 2>/dev/null)
if [ -n "$BRANCH" ]; then
    echo "🌿 Branch: $BRANCH" >&2
fi

exit 0

#!/bin/bash
# Checks before building

# Ensure we're not on main branch with uncommitted changes
BRANCH=$(git branch --show-current 2>/dev/null)
if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
    CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
    if [ "$CHANGES" -gt "0" ]; then
        echo "⚠️  Warning: Building on main with uncommitted changes" >&2
    fi
fi

exit 0

#!/bin/bash
# Auto-format Swift files after editing

INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"\(.*\)"/\1/')

if [[ "$FILE_PATH" == *.swift ]]; then
    # Only run if formatters exist
    if [ -f ".swiftformat" ] && command -v swiftformat &> /dev/null; then
        swiftformat "$FILE_PATH" 2>/dev/null || true
        echo "✨ Formatted $FILE_PATH" >&2
    fi
    
    if [ -f ".swiftlint.yml" ] && command -v swiftlint &> /dev/null; then
        swiftlint lint --fix "$FILE_PATH" 2>/dev/null || true
    fi
fi

exit 0

chmod +x .claude/hooks/*.sh

{
  "env": {
    "PROJECT_NAME": "[Your project name]",
    "DEFAULT_SIMULATOR": "iPhone 15",
    "SWIFT_VERSION": "[From analysis]"
  },
  "hooks": {
    "SessionStart": [{
      "matcher": ".*",
      "hooks": [{
        "type": "command",
        "command": ".claude/hooks/session-start.sh"
      }]
    }],
    "PostToolUse": [{
      "matcher": "Edit.*\\.swift|Write.*\\.swift",
      "hooks": [{
        "type": "command",
        "command": ".claude/hooks/post-swift-edit.sh"
      }]
    }]
  }
}

{
  "permissions": {
    "allow": [
      "mcp__xcodebuildmcp__*",
      "Read",
      "Write",
      "Edit",
      "Bash(git*)",
      "Bash(swift*)",
      "WebFetch"
    ]
  }
}

# [Package Name] Package

## Purpose
[What this package does]

## Structure
- Sources/
- Tests/

## Testing
Run tests with: `mcp__xcodebuildmcp__swift_package_test`

## Key APIs
[List main public interfaces]

# [Extension Name]

## Type
[Widget/Watch/Share/etc]

## Building
Use scheme: [Scheme name]

## Testing
[How to test this extension]

# Claude Code Configuration

This directory contains all Claude Code setup for this iOS project.

## Quick Command Reference

**Building & Running:**
- `/build` - Build the project
- `/run` - Build and run in simulator
- `/clean` - Clean build artifacts

**Testing:**
- `/test` - Run tests
- `/test-all` - Run all tests
- `/test-single [name]` - Run specific test

**Device:**
- `/device-list` - Show connected devices
- `/device-build` - Deploy to device

**Maintenance:**
- `/update-docs` - Update documentation
- `/claude-optimize` - Optimize setup

## Directory Structure

## How Commands Work
Each .md file in commands/ becomes a slash command.
The filename (without .md) is the command name.

## How Hooks Work
Hooks run automatically at specific times:
- session-start.sh: When Claude Code starts
- post-swift-edit.sh: After editing Swift files

# Verify MCP is working
mcp__xcodebuildmcp__diagnostic

# If this fails, MCP may not be enabled
# User should check Claude Code settings

/build       # Should build the project
/test        # Should run tests
/run         # Should launch in simulator
/clean       # Should clean build artifacts

# Test the context script
DEBUG_CONTEXT=true bash .claude/scripts/detect-context.sh

# Should show:
# - Project file path
# - Default scheme
# - Default simulator
# - Current context

# Solution: MCP may not be enabled in Claude Code
# The user needs to check their Claude Code settings
# Or ensure Node.js is installed:
brew install node

# Solution: Ensure .claude/commands/ directory exists
# and contains .md files with proper frontmatter:
---
description: Your description here
---

# Solution: Make hooks executable
chmod +x .claude/hooks/*.sh

# And ensure paths in settings.json are correct

# Solution: List available schemes
xcodebuild -list -project *.xcodeproj

# Update detect-context.sh with correct scheme

# Solution: List available simulators
xcrun simctl list devices

# Update defaults in detect-context.sh