xclaude-plugin

xClaude Plugin

/plugin marketplace add conorluddy/xclaude-plugin

Modular iOS development automation for Claude Code

Build, test, and automate iOS apps through natural conversation with Claude. 8 workflow-specific MCP servers with 22 tools across Xcode, Simulator, and IDB.

Tools are grouped into MCPs - you enable the ones you're currently need and disable others to optimise context. I still need to revise and optimise the groupings.

Features

🎯 Modular Architecture

• 8 workflow-specific MCP servers (300-3500 tokens each)
• Enable only what you need - Ultra-minimal to full-featured
• 22 shared tools across Xcode, Simulator, and IDB
• Single source of truth - tools defined once, imported by MCPs

🔥 Surgical MCPs (Ultra-Focused)

• xc-compile (~300 tokens) - Just build with error extraction
• xc-interact (~900 tokens) - Pure UI interaction, no build

📦 Core Workflow MCPs

• xc-build (~600 tokens) - Build validation with clean/scheme discovery
• xc-ai-assist (~1400 tokens) - Build + UI automation + screenshots
• xc-setup (~800 tokens) - Environment configuration and validation
• xc-testing (~1200 tokens) - Test execution + UI flows
• xc-meta (~700 tokens) - Project maintenance and housekeeping

🚀 Full Access

• xc-hybrid (~3500 tokens) - All 22 tools for complex workflows

📚 8 Procedural Skills (Loaded On-Demand)

• xcode-workflows - Build system guidance and result analysis
• simulator-workflows - Device and app lifecycle patterns
• ui-automation-workflows - Accessibility-first automation
• accessibility-testing - WCAG compliance and quality checks
• ios-testing-patterns - Test execution and flaky test detection
• crash-debugging - Crash log analysis and symbolication
• performance-profiling - Instruments integration
• state-management - Cache and configuration management

Installation

From GitHub (Recommended)

/plugin marketplace add conorluddy/xclaude-plugin
/plugin install xclaude-plugin

From Local Development

/plugin marketplace add /path/to/xclaude-plugin
/plugin install xclaude-plugin

Requirements

• macOS 13.0+ or Linux
• Xcode 15.0+ (macOS only, for iOS development)
• Node.js 18+
• Optional: IDB (Facebook iOS Development Bridge) for advanced UI automation

Quick Start

Enable the Right MCP for Your Task

IMPORTANT: Enable ONE MCP at a time for optimal token efficiency. Choose based on your current workflow:

☐ xc-compile        # Just fixing compilation errors? (~300 tokens)
☐ xc-interact       # Testing UI with app already built? (~900 tokens)
☐ xc-build          # Need clean/scheme discovery too? (~600 tokens)
☐ xc-ai-assist      # AI-driven UI iteration? (~1400 tokens)
☐ xc-setup          # First time setup? (~800 tokens)
☐ xc-testing        # Running test suites? (~1200 tokens)
☐ xc-meta           # Maintenance tasks? (~700 tokens)
☐ xc-hybrid         # Complex workflow needing everything? (~3500 tokens)

Example Workflows

Scenario 1: Rapid compilation fixes

Enable: xc-compile (~300 tokens)

"Build the project and show me the errors"

→ Uses xcode_build with automatic error extraction
→ Returns up to 10 errors for quick fixes
→ 87% less tokens than old architecture!

Scenario 2: Testing UI flows (app already built)

Enable: xc-interact (~900 tokens)

"Tap the Login button, then check if the profile screen appears"

→ Queries accessibility tree (3-4x faster than screenshots)
→ Taps elements by coordinates
→ Validates UI state without rebuilding

Scenario 3: AI-driven UI iteration

Enable: xc-ai-assist (~1400 tokens)

"Update the button color to blue, rebuild, and show me a screenshot"

→ Modifies code, builds, captures screenshot
→ Complete workflow in one MCP
→ Includes visual feedback (screenshots)

Architecture

Modular MCP Design