xclaude-plugin
starsforks
How to install xclaude-plugin?
conorluddy/xclaude-plugin
$git clone https://github.com/conorluddy/xclaude-pluginiOS development ClaudeCode plugin for mindful token and context usage. Contains modular MCPs that group various Xcode/IDB tools based on your current workflow.
README.md
| 1 | # xClaude Plugin |
| 2 | |
| 3 | ``` |
| 4 | /plugin marketplace add conorluddy/xclaude-plugin |
| 5 | ``` |
| 6 | |
| 7 | **Modular iOS development automation for Claude Code** |
| 8 | |
| 9 | Build, test, and automate iOS apps through natural conversation with Claude. 8 workflow-specific MCP servers with 24 tools across Xcode, Simulator, and IDB. |
| 10 | |
| 11 | **Enable only what you need.** Each MCP is purpose-built for specific workflows, keeping your context window lean. Plus, our tools intelligently encapsulate Xcode output (errors, test results, build logs) so Claude processes structured JSON instead of raw 50+ line logs—saving significant tokens and enabling faster feedback loops. |
| 12 | |
| 13 | <img width="1278" height="407" alt="Screenshot 2025-11-08 at 10 44 28" src="https://github.com/user-attachments/assets/ff1c0a09-f29d-4a86-a280-97b3bbc8c635" /> |
| 14 | |
| 15 | ## Features |
| 16 | |
| 17 | ### 🎯 Modular Architecture |
| 18 | |
| 19 | - **8 workflow-specific MCP servers** (600-3500 tokens each) |
| 20 | - **Enable only what you need** - Ultra-minimal to full-featured |
| 21 | - **23 shared tools** across Xcode, Simulator, and IDB |
| 22 | - **Single source of truth** - tools defined once, imported by MCPs |
| 23 | |
| 24 | ### 🔥 Surgical MCPs (Ultra-Focused) |
| 25 | |
| 26 | - **xc-build** (~600 tokens) - Build validation, errors, clean, list schemes |
| 27 | - **xc-launch** (~400 tokens) - Simulator app lifecycle: install and launch |
| 28 | - **xc-interact** (~900 tokens) - Pure UI interaction, no build |
| 29 | |
| 30 | ### 📦 Core Workflow MCPs |
| 31 | |
| 32 | - **xc-ai-assist** (~1400 tokens) - Build + UI automation + screenshots |
| 33 | - **xc-setup** (~800 tokens) - Environment configuration and validation |
| 34 | - **xc-testing** (~1200 tokens) - Test execution + UI flows |
| 35 | - **xc-meta** (~700 tokens) - Project maintenance and housekeeping |
| 36 | |
| 37 | ### 🚀 Full Access |
| 38 | |
| 39 | - **xc-all** (~3500 tokens) - All 24 tools for complex workflows |
| 40 | |
| 41 | ### 📚 8 Procedural Skills (Loaded On-Demand) |
| 42 | |
| 43 | - **xcode-workflows** - Build system guidance and result analysis |
| 44 | - **simulator-workflows** - Device and app lifecycle patterns |
| 45 | - **ui-automation-workflows** - Accessibility-first automation |
| 46 | - **accessibility-testing** - WCAG compliance and quality checks |
| 47 | - **ios-testing-patterns** - Test execution and flaky test detection |
| 48 | - **crash-debugging** - Crash log analysis and symbolication |
| 49 | - **performance-profiling** - Instruments integration |
| 50 | - **state-management** - Cache and configuration management |
| 51 | |
| 52 | ## Installation |
| 53 | |
| 54 | ### From GitHub (Recommended) |
| 55 | |
| 56 | ```bash |
| 57 | /plugin marketplace add conorluddy/xclaude-plugin |
| 58 | /plugin install xclaude-plugin |
| 59 | ``` |
| 60 | |
| 61 | ### From Local Development |
| 62 | |
| 63 | ```bash |
| 64 | /plugin marketplace add /path/to/xclaude-plugin |
| 65 | /plugin install xclaude-plugin |
| 66 | ``` |
| 67 | |
| 68 | ## First 60 Seconds |
| 69 | |
| 70 | Just installed? Enable **xc-build** and **xc-launch** for rapid development: |
| 71 | |
| 72 | ``` |
| 73 | 1. In Claude settings, enable "xc-build" and "xc-launch" MCPs |
| 74 | 2. Ask Claude: "Build and run MyApp on iPhone 15" |
| 75 | 3. Done! ✨ |
| 76 | ``` |
| 77 | |
| 78 | That's it. **xc-build** + **xc-launch** gives you a composable development loop: build with xc-build, then install & launch with xc-launch. Claude orchestrates the two-step workflow. If you need other workflows (testing, setup, UI automation), see **Choosing the Right MCP** below. |
| 79 | |
| 80 | ## Requirements |
| 81 | |
| 82 | - macOS 13.0+ or Linux |
| 83 | - Xcode 15.0+ (macOS only, for iOS development) |
| 84 | - Node.js 18+ |
| 85 | - Optional: IDB (Facebook iOS Development Bridge) for advanced UI automation |
| 86 | |
| 87 | ## Migration Guide (v0.4.0) |
| 88 | |
| 89 | If you're upgrading from an earlier version, note these breaking changes: |
| 90 | |
| 91 | ### Renamed Server: `xc-build-and-launch` → `xc-launch` |
| 92 | |
| 93 | **What changed:** |
| 94 | - Server renamed from **xc-build-and-launch** to **xc-launch** for clarity |
| 95 | - **Removed:** `xcode_build_and_launch` monolithic tool (with `skip_build` flag), plus `xcode_build`, `xcode_clean`, `xcode_list` (moved to xc-build) |
| 96 | - **Now contains:** Only `simulator_install_app` and `simulator_launch_app` |
| 97 | - **Philosophy:** Use **xc-build** + **xc-launch** together for development loop |
| 98 | |
| 99 | **Why:** The monolithic `xcode_build_and_launch` tool coupled build, install, and launch into a single operation. The new architecture separates build concerns (xc-build) from simulator lifecycle (xc-launch), enabling: |
| 100 | - Better error recovery (retry individual steps) |
| 101 | - Clearer mental model (build → install → launch) |
| 102 | - No `skip_build` code smell |
| 103 | - Follows Single Responsibility Principle |
| 104 | |
| 105 | **Action required:** |
| 106 | 1. Update your `.mcp.json` configuration: |
| 107 | ```diff |
| 108 | - "xc-build-and-launch": { |
| 109 | - "command": "node", |
| 110 | - "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/xc-build-and-launch/dist/index.js"] |
| 111 | + "xc-launch": { |
| 112 | + "command": "node", |
| 113 | + "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-servers/xc-launch/dist/index.js"] |
| 114 | ``` |
| 115 | 2. In Claude settings, enable "xc-launch" instead of "xc-build-and-launch" |
| 116 | |
| 117 | **Previous versions:** |
| 118 | - `v0.3.0`: `xc-run` → `xc-build-and-launch` |
| 119 | - `v0.3.0`: `xc-compile` → `xc-build`, `xc-hybrid` → `xc-all` |
| 120 | |
| 121 | See `.mcp.json.example` for the current configuration. |
| 122 | |
| 123 | ## Choosing the Right MCP |
| 124 | |
| 125 | ### Enable the Right MCP for Your Task |
| 126 | |
| 127 | **IMPORTANT**: Enable **ONE MCP at a time** for optimal token efficiency. Choose based on your current workflow: |
| 128 | |
| 129 | ``` |
| 130 | ☐ xc-build # Bui |
People who liked this also viewed
6 picksType
- fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 2025
- lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 2026
- rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026
- FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026
- repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026
- mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026
