xclaude-plugin

Name: xclaude-plugin
Author: conorluddy

byconorluddy· 3 MCP servers

Stars

178

Forks

How to install xclaude-plugin?

conorluddy/xclaude-plugin

$git clone https://github.com/conorluddy/xclaude-plugin

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install xclaude-plugin by running `git clone https://github.com/conorluddy/xclaude-plugin`, then use it for the current task and follow its documentation at https://github.com/conorluddy/xclaude-plugin.

Files · 1

View on GitHub

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

6 picks

Type

Install xclaude-plugin by running `git clone https://github.com/conorluddy/xclaude-plugin`, then use it for the current task and follow its documentation at https://github.com/conorluddy/xclaude-plugin.

xclaude-plugin

How to install xclaude-plugin?

Related

xclaude-plugin

How to install xclaude-plugin?

Related